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I.  Introduction 


A.  Purpose  of  the  Package 

The  purpose  of  the  Flood  Damage  Analysis  (FDA)  Package  is  to  link 
hydrologic  and  economic  computer  programs  developed  by  the  Hydrologic 
Engineering  Center  (HEC) .  The  programs  are  linked  through  a  data  management 
system,  developed  by  HEC,  which  is  called  the  Hydrologic  Engineering  Center 
Data  Storage  System  (HECDSS)  or  the  Data  Storage  System  (DSS).  This  linkage 
facilitates  the  automatic  transfer  of  data  between  computer  programs  with 
minimal  effort  by  the  analyst.  Instead  of  manually  entering  data,  the  analyst 
assigns  an  alphanumeric  label  to  the  data  and  that  label  is  used  to  store  and 
retrieve  data.  The  HEC  has  completed  the  development  and  documentation  of 
this  coordinated,  linked  family  of  programs. 

B.  Background  and  Overview 

Flood  damage  analysis  is  performed  to  provide  quantitative  information  on 
the  social  cost  of  flooding  and  to  provide  a  basis  for  formulating, 
evaluating,  and  implementing  a  range  of  remedial  construction  projects  and 
other  management  actions.  Flood  damage  potential  assessments  of  existing 
flood  plain  development  provide  the  basis  for  identifying  critical  problem 
areas  and  for  development  of  actuarial  insurance  premiums  for  government  and 
private  industry.  Damage  appraisals  performed  in  the  aftermath  of  flood 
events  provide  the  data  used  as  the  basis  for  the  efficient  and  equitable 
allocation  of  relief  funds  and  other  emergency  assistance.  Damage  estimates 
of  potential  future  development  scenarios  can  encourage  local  government 
agencies  and  private  individuals  to  make  wise  land  use  decisions  considering 
the  flood  hazard  consequences.  Several  types  of  analysis  for  a  range  of 
development  conditions  and  careful  segmenting  of  damageable  areas  are  required 
to  meet  these  information  needs. 

For  a  number  of  years,  the  HEC  has  been  active  in  developing  a  variety  of 
computer  programs  to  meet  these  needs.  The  programs  have  been  used 
extensively  individually  and  occasionally  congruently.  Recent  developments  in 
data  management  computer  software  have  provided  an  opportunity  to  link  these 
programs  in  a  highly  efficient  data  file  management  mode  that  now  permits 
packaging  (in  a  conceptual  analysis  sense)  to  form  a  coordinated,  linked 
family  of  flood  damage  analysis  programs. 

The  programs  collectively  provide  capability  for  flood  damage  analysis  for 
the  full  range  of  structural  and  nonstructural  flood  plain  management 
measures.  The  package  presently  includes  three  computer  programs  for 
performing  hydrologic  engineering  analysis,  three  programs  for  flood  damage 
analysis,  and  the  HEC  Data  Storage  System.  Evaluation  of  structural  measures 
such  as  reservoirs,  channels,  levees,  diversions,  and  non-structural  measures 
such  as  flood  proofing,  structure  relocation,  and  management  of  future 
development  can  be  accomplished  by  the  appropriate  use  and  linking  of  the 
programs.  The  programs  may  be  used  individually,  or  in  any  needed 
combination,  and  the  system  can  accommodate  direct  data  input  as  might  be 
available  from  computer  programs  in  use  by  others  or  from  published  data. 

This  document  briefly  overviews  the  basic  concepts  of  flood  damage 
computations,  describes  the  coordinated  linked  set  of  programs  (referred  to  as 


the  Flood  Damage  Analysis  Package),  and  provides  suggested  study  procedures  to 
efficiently  use  the  package.  Also  included  are  supplementary  user 
documentation  as  needed,  data  management  information  and  a  complete  narrated 
and  executed  example. 

The  package  of  programs  is  maintained  and  distributed  by  the  Hydrologic 
Engineering  Center,  Water  Resources  Support  Center,  U.S.  Army  Corps  of 
Engineers,  609  Second  Street,  Davis,  California  95616. 
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II.  Flood  Damage  Computation  Overview 


A.  Basic  Approaches 

Expected  annual  flood  damage  computations  may  be  performed  by  two 
distinctly  different  approaches.  One  is  to  develop  a  chronologically  long 
period  of  annual  damage  values  and  compute  the  average  value.  The  value  may 
be  derived  either  from  historic  records  of  incurred  damage  data  or  simulation 
of  damage  as  it  might  occur  on  an  annual  basis.  Projects  and  other  management 
measures  are  evaluated  in  terms  of  their  expected  effect  on  the 
chronologically  long  period  of  annual  damage  values. 

Another  approach  to  annual  damage  computations  is  to  develop  the  data  in  a 
way  that  determines  the  potential  for  damage  from  specific  flood  events  and 
weights  the  damage  values  with  the  probability  that  these  events  might  be 
exceeded.  The  result  is  the  expected  annual  damage  value  (sometimes  referred 
to  as  average  annual  damage).  Projects  and  other  management  actions  are  / 
evaluated  by  determining  their  expected  effect  on  the  basic  relationships  that 
determine  the  damage  in  any  year  and  then  recomputing  the  expected  annual 
damage.  This  latter  approach,  often  referred  to  as  the  frequency  method,  is 
the  primary  reason  that  the  Flood  Damage  Analysis  Package  has  been  developed. 

B.  Flood  Damage  By  Frequency  Method 

The  Expected  Annual  Flood  Damage  Computation  (EAD)  Users  Manual  (3) 
describes  the  frequencv  method,  illustrates  basic  concepts  with  charts,  and 
provides  guidance  for  developing  data  to  perform  the  computations.  This 
section  contains  excerpts  from  that  material.  The  reader  is  referred  to  the 
EAD  manual  for  a  more  complete  discussion  of  the  method. 

The  frequency  method  is  based  on  the  principle  that  flood  damage  to  an 
individual  structure,  group  of  structures,  or  damageable  property  within  a 
flood  plain  reach  can  be  estimated  by  determining  the  dollar  value  of  flood 
damage  for  different  magnitudes  of  flooding  and  by  estimating  the  percent 
chance  of  exceedance  of  each  of  these  flood  magnitudes.  The  damage  caused  by 
a  single  flood  event  of  known  magnitude  is  estimated  directly  from  a  damage 
relationship.  When  it  is  desired  to  compute  the  damage  which  can  be  expected 
in  an  average  year,  then  the  damage  corresponding  to  each  magnitude  of 
flooding  is  weighted  by  the  probability  of  each  being  exceeded  (damage  caused 
by  rare  events  are  thus  weighted  less).  The  sum  of  the  weighted  damage 
represents  the  expected  annual  flood  damage.  The  objective  of  much  of  the 
preparatory  technical  analysis  is  the  development  of  an  exceedance  frequency- 
damage  relationship  that  subsequently  can  be  integrated  numerically  to  yield 
the  expected  annual  value. 

There  are  several  different  combinations  in  which  the  stage,  flow,  damage 
and  frequency  data  can  be  expressed  to  develop  the  final  frequency- damage 
relationship.  The  simplest  way  is  to  relate  stage  or  flow  to  damage  and  to 
relate  stage  or  flow  to  exceedance  frequency.  The  common  parameter,  stage  or 
flow,  can  be  used  to  relate  damage  to  exceedance  frequency.  If  the  damage  and 
frequency  data  are  not  directly  related  to  a  common  parameter,  then  another 
relationship  must  be  used.  This  is  commonly  a  stage-flow  relationship.  Thus, 
if  damage  is  expressed  as  a  function  of  stage  and  exceedance  frequency  as  a 
function  of  flow,  damage  can  be  related  to  frequency  with  the  stage-flow 
function.  Figure  1,  taken  from  (3),  summarizes  the  basic  technical  analysis 
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needed,  derived  functional  relationships,  and  general  processing  to  develop 
the  damage-exceedance  frequency  function. 

Because  stage,  flow,  frequency  and  damage  relationships  vary  along  a 
river,  it  is  common  practice  to  divide  a  river  into  reaches  and  designate  a 
set  of  these  relationships  to  represent  the  stage,  flow,  frequency  and  damage 
data  for  a  reach.  An  index  location  is  selected  within  the  reach  and  a  single 
stage  or  flow-frequency  relationship  and  stage-flow  relationship  are  applied 
at  that  location  and  considered  representative  of  these  variables  for  the 
entire  reach.  In  the  case  of  damage,  several  relationships  are  usually  used, 
each  representative  of  a  particular  damage  category. 

One  reason  for  computing  flood  damage  is  to  evaluate  several  basin 
conditions.  A  typical  analysis  includes  the  determination  of  expected  annual 
damage  for  without  conditions.  Appropriate  simulations  must  be  performed 
including  (as  needed)  reservoir  operations,  channel  improvements,  levees, 
diversions,  etc.  If  it  is  forecast  that  future  development  (i.e.  increased 
urbanization)  will  occurr  in  the  basin  or  that  flood  plain  occupants  will 
enjoy  an  increase  in  affluence,  the  without  condition  must  be  evaluated  in 
terms  of  equivalent  annual  damage.  Regulations  prohibit  the  inclusion  of 
inflation  (or  deflation)  in  the  economic  evaluations.  However,  to  compute 
equivalent  annual  damage,  the  present  value  of  damage  at  some  future  points  in 
time  must  be  determined  and  then  it  must  be  amoritized  into  an  equivalent 
annual  value.  This  establishes  the  expected  annual  damage  for  without 
conditions . 

A  principal  reason  for  computing  flood  damage  is  to  determine  the 
effectiveness  of  different  flood  plain  management  plans  in  reducing  damage.  If 
significant  damage  occurs  in  the  basin,  responsible  agencies  will  try  to 
formulate  measures  to  reduce  it.  These  measures  might  include  building  a 
reservoir,  modifying  the  channel,  or  floodproofing  structures.  To  evaluate 
these  measures,  the  analyst  will  define  several  flood  damage  mitigation  plans. 
Each  plan  will  consist  of  one  or  more  damage  reduction  measures.  This 
reduction  commonly  is  referred  to  as  an  inundation  reduction  benefit  and  is 
measured  as  the  difference  in  expected  annual  flood  damage  with  and  without  a 
plan.  Different  management  plans  alter  the  stage,  flow,  frequency,  and/or 
damage  relationships  in  different  ways.  Table  1  summarizes  these  concepts  and 
changing  relationships.  With  a  modified  relationship  the  damage  is  different, 
usually  lower,  than  without  the  plan.  Thus,  for  any  plan  which  causes  a 
change  which  can  be  quantified,  damage  with  the  plan  can  be  computed. 


The  HEC  flood  damage  analysis  package  has  tied  specific  HEC  programs 
together  through  the  mechanism  of  an  HEC-developed  data  management  system  in 
such  a  way  that  all  the  relevant  functions  can  be  developed  and  computations 
performed  in  a  highly  automated  yet  user  controlled  manner.  The  next  section 
describes  the  overall  structure  for  the  package  and  briefly  reviews  the 
individual  components. 


III.  HEC  Flood  Damage  Analysis  Package 

A.  Basic  Components 

The  HEC  Flood  Damage  Analysis  Package  is  schematically  illustrated  in 
Figure  2.  The  package  is  comprised  of  the  following  computer  programs: 

1.  Hydrologic  Analysis  Computer  Programs 

o  HEC-1  Flood  Hydrograph  Package  (5);  simulates  rainfall-runoff, 
simple  reservoirs  and  hydrologic  channel  routing;  used  to  develop 
existing,  without  conditions,  and  modified  conditions 
flow- frequency  curves. 

o  HEC-2  Water  Surface  Profiles  (15);  computes  steady-state,  uniform 
flow  profiles;  used  to  develop  elevation-flow  rating  curves. 

o  HEC-5  Simulation  of  Flood  Control  and  Conservation  Systems  (11); 
simulates  complex  reservoir  systems;  used  to  develop  existing, 
without  and  modified  flow-frequency  curves. 

2 .  Flood  Damage  Analysis  Computer  Programs 

o  SID,  Structure  Inventory  For  Damage  Analysis  (12);  processes 
inventories  of  structures  located  in  the  flood  plain;  used  to 
develop  elevation-damage  relationships. 

o  SIDEDT,  Structure  Inventory  For  Damage  Analysis  Edit  Program  (13); 
edits  structure  inventory  and  damage  function  files  u;;«ed  for  the 
SID  program. 

o  DAMCAL,  Damage  Reach  Stage-Damage  Calculation  (2);  performs  same 
analysis  as  SID  except  based  on  a  geographic  (spatial)  unit;  used 
to  develop  elevation-damage  relationships. 

o  Expected  Annual  Damage  Computation  -  EAD  (3);  computes  expected 
(or  equivalent)  annual  damage  and  inundation  reduction  benefits; 
used  to  compare  flood  damage  mitigation  plans. 

3.  HEC-DSS  (Data  Management)  Utility  Programs 

o  PIP,  Interactive  Paired-Function  Input  Program  (10);  directly 
inputs  paired  function  relationships  to  a  DSS  data  file,  for 
example,  an  elevation-damage  relationship  derived  by  hand  from 
field  data. . 

o  DSSUTL,  HEC-DSS  Utility  Program  (8);  provides  the  means  of 

performing  utility  functions  on  data  stored  in  the  HEC-DSS  data 
file,  for  example,  cataloging,  editing,  and  deleting  data. 

o  DSPLAY,  HEC-DSS  Display  Program  (8);  Provides  the  means  to  tabulate 
and  plot  data  stored  in  a  HBC-DSS  data  file. 
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If  flood  damage  computations  are  based  on  conventional  structure 
inventories,  then  a  structure  file  is  constructed  based  on  a  field  inventory 
of  structures  vulnerable  to  flood  damage.  If  damage  computations  are 
spatially  based,  then  a  grid  cell  data  bank  is  constructed.  It  is  possible 
that  both  damage  approaches  may  be  used  for  a  given  study,  in  which  case  both 
files  will  exist.  HEC's  Data  Storage  System  is  a  set  of  software  that  allows 
the  user  to  store  data  in  a  file  and  manage  that  data.  The  components  are 
described  in  more  detail  later  in  this  section  and  the  capabilities  of  each 
component  are  summarized  in  Appendix  A. 


B.  Terminology 


The  basic  terminology  used  to  define  the  flood  magnitude,  frequency  and 
damage  vary  among  Corps  Districts.  For  the  FDA  package,  the  water  surface 
descriptors  are  stage  and  elevation.  Stage  is  used  herein  as  a  term  to 
represent  both  the  situation  in  which  a  local  datum  is  used  for  each  location 
in  the  study  area  and  also  for  the  more  general  case  of  a  common  datum  for  the 
entire  study  area.  In  the  latter  case,  "elevation”  is  often  used  by  others  as 
an  appropriate  term.  This  document  uses  stage  and  elevation  interchangeably. 
It  is  desirable  for  all  participants  in  a  study  to  use  "elevation"  based  on 
common  datum.  An  exception  to  this  is  the  stage-damage  functions  (or  stage- 
percent  damage  functions)  input  to  the  SID  program.  They  usually  reference 
the  first  floor  as  a  stage  of  zero.  The  aggregated  elevation-damage 
relationships  for  each  reach  are  then  computed  from  the  known  first  floor 
elevation . 


C.  Parametric  Relationships  Used  in  the  Package 


The  package  of  programs  and  data  management  elements  are  designed  to  be 
used  as  an  integrated  set,  as  partial  separate  elements,  or  even  as  a  final 
repository/processing  capability  for  data  developed  by  other  programs  or 
procedures.  It  is  envisioned  that  each  of  the  hydrologic  engineering  and 
flood  damage  function  development  programs  would  be  used  independently  by  the 
specialist  working  in  their  respective  areas.  For  example,  a  hydraulic 
engineer  will  determine  elevation-discharge  rating  curves  at  selected 
locations  using  HEC-2  and  store  the  curves  in  the  DSS  data  file. 
Simultaneously,  an  economist  will  inventory  structures  in  the  flood  plain  to 
compute  elevation-damage  relationships  for  those  same  index  locations  using 
SID  and  store  the  curves  in  the  same  DSS  data  file.  Other  analyses  also  will 
be  performed  simultaneously  (such  as  rainfall-runoff  and  reservoir  systems) 
and  the  pertinent  parametric  relationships  (flow-frequency  curves)  stored  in 
the  same  DSS  file.  Each  of  the  analysts  must  meet  with  the  study  manager  to 
establish: 


(1)  a  list  of  index  locations  at  which  the  pertinent  relationships  will  be 
computed,  and 


(2)  a  convention  for  the  alphanumeric  labels  which  will  identify  the 
locations,  the  damage  alternative  plans,  and  the  study  (this  is  discussed  in 
Appendix  A) . 


The  basic  concept  is  that  each  of  the  major  data  types  is  developed  by  the 
applicable  computer  programs  and  the  results  written  to  the  DSS  file  with 
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The  basic  and  derived  evaluatian  relationships  are  sho«n  above.  Concepts 
ioportant  to  their  construction  are  described  herein. 

Stage-Flot  Relationship:  This  is  a  basic  hydraulic  function  that  shots  lor  a 
speciftc  location,  the  relationship  between  flow  rate  and  stage  It  is 
Irequently  referred  to  as  a  ‘rating  curve'  and  is  normally  derived  from  water 
surface  profile  computations. 

Stage-Damage  Relationship:  This  is  the  economic  counterpart  to  the  stage 
flow  function  and  represents  the  damage  which  will  occur  tor  various  river 
stages.  Usually  the  damage  represents  an  aggregate  of  the  damage  which  could 
occur  some  distance  upstream  and  downstream  from  the  specified  location.  It 
is  usually  developed  from  field  damage  surveys. 

F I o»  F requency  Relationship  This  defines  the  relationship  between  eiceedance 
frequency  and  flow  at  a  location.  It  is  the  basic  function  describing  the 
probability  nature  ol  stream  (low  and  is  commonly  deteimined  from  either 
statistical  analysis  of  gaged  flow  data  or  through  watershed  model  calculations. 

Damage-Frequency  Relationship:  This  relationship  is  derived  by  combining  the 
basic  relationships  using  the  common  parameters  stage  and  flow  For  eiample, 
the  damage  lor  a  specific  eiceedance  frequency  is  deteimined  by  ascertaining 
the  corresponding  flow  rale  from  the  f  I  ow- 1  requency  function  the  corresponding 
stage  from  the  stage  flow  function  and  finally  the  corresponding  damage  from 
the  stage-damage  relationship.  Any  changes  which  occur  in  the  basic  relationships 
because  of  watershed  development  or  flood  plain  management  measure  implementation 
will  change  the  damage  -  f requency  function  and  therefore  the  eipected  annual 
damage  that  is  computed  as  the  integral  of  the  function  (area  underneath). 

Dther  Functional  Relationship:  The  flow-damage  relationship  is  developed  by 
combining  the  stage-damage  with  the  stage-flow  relationship  using  stage  as 
the  common  parameter.  The  stage  frequency  relationship  is  developed  by 
combining  the  stage-flow  with  the  f I ow- f requency  relationship  using  flow  as 
the  common  parameter.  The  damage - f requency  relationship  could  then  be 
developed  as  a  further  combination  of  these  derived  relationships. 


Figure  1  Basic  and  Derived  Relationships 


Table  1:  Effect  of  Flood  Plain  Management  Measures 


Impacted  Relationship^ 


Measure 

Stage- 

flow 

Stage- 

Damage 

Flow- 

DamaRe 

Flow- 

Frequency 

Damage- 

Frequency 

Reservoir^ 

NC 

NC 

NC 

M 

H 

Levee  or  floodwall* 

M 

M 

M 

M* 

M 

Channel  Modification* 

M 

NC 

M 

M» 

M 

Diversion* 

NC 

NC 

NC 

M 

M 

Flood  Forecasting 

NC 

NC 

NC 

M 

M 

Flood  Proofing 

NC 

M 

M 

NC 

M 

Relocation 

NC 

M 

M 

NC 

M 

Flood  Warning 

NC 

M 

M 

NC 

M 

Land  Use  Control* 

NC 

M 

M 

M 

M 

^  The  following  codes  apply  to  the  table  above: 

NC  =  No  Change  in  parametric  relationship 
M  =  Modification  to  parametric  relationship 

^  Long-term  effects  resulting  from  a  change  in  stream  regime  induced 
by  these  measures  could  affect  the  basic  stage-flow  relationship  and 
thus  other  derived  relationships  at  some  future  date. 

^  Elimination  of  significant  amounts  of  flood  plain  storage  can 
result  in  downstream  effects  on  flow-frequency  relationship. 

*  The  impact  indicated  is  that  which  would  occur  to  a  future  condition 
in  the  absence  of  the  measure. 


The  basic  relationships  that  comprise  the  frequency  method  (Figure  1)  are 
developed  in  a  variety  of  ways  by  Corps  field  offices.  Most  analysts  derive 
the  stage-flow  (rating  curve)  by  computing  water  surface  profiles  with  one  of 
the  readily  available  computer  programs.  Some  analysts  combine  the  stage-flow 
and  stage- damage  steps  in  an  alternative  approach  wherein  flow  lines  (flood 
plain  outlines  for  a  range  of  flood  events)  are  drawn  on  maps,  potential 
damage  identified  within  the  flooded  areas,  and  flow-damage  relationships 
developed  directly.  More  commonly,  stage-damage  relationships  are  developed 
through  an  inventory  process  (of  individual  or  groups  of  structures),  and  then 
the  inventory  results  are  aggregated  to  form  one  or  more  categories  of  damage 
relationships.  Flow- frequency  is  developed  through  either  direct  analysis  of 
historic  records  or  by  use  of  computations  with  hydrologic  models,  or  a 
combination  of  both.  Corps  field  offices  often  manipulate  the  resulting 
functions  with  their  own  annual  damage  computer  programs  or  use  one  or  more  of 
the  HEC  programs. 
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appropriate  identifying  labels.  The  data  can  then  be  subsequently  retrieved 
and  used  by  other  computation  programs  if  the  appropriate  identifying  label  is 
input  to  the  program. 

1 .  Flow-Frequency  Data 

The  hydrologic  engineer  will  perform  conventional  analysis  to  develop  a 
rainfall-runoff  model  (HEC-1)  of  the  study  area  and  set  the  program  to  run  in 
the  multi-plan  evaluation  mode  (see  HEC-1  User's  Manual).  Execution  would 
cause  the  base  condition  and  subsequent  alternative  conditions  flow- exceedance 
frequency  curves  developed  autoiaatically  during  HEC-1  program  execution  to  be 
written  to  the  DSS  file  with  the  appropriate  identifying  labels.  If  reservoir 
system  operation  is  an  element  of  the  study,  then  hydrographs  would  instead  be 
written  to  the  DSS  file  for  subsequent  retrieval  and  operation  with  the  HEC-5 
program.  The  HEC-5  program  is  then  executed  for  the  alternatives  of  interest 
in  its  plan  evaluation  mode  (see  HEC-5  User's  Manual)  and  the  subsequent  flow- 
frequency  results  written  to  the  DSS  file  with  the  appropriate  identifying 
labels . 

2.  Elevation-Discharge  Data 

Water  surface  profile  computations  would  be  performed  conventionally. 

After  completion  of  calibration  analysis,  HEC-2  is  executed  for  the  stream 
conveyance  alternatives  of  interest  using  the  multiple  profile  mode  (see  HBC-2 
User's  Manual)  and  the  resulting  elevation-flow  results  written  to  the  DSS 
file  with  appropriate  pathname  labels. 

3.  Elevation-Damage  Data 

Two  alternatives  are  possible  for  development  of  elevation-damage 
relationships  using  programs  in  this  package.  One  is  conventional  structure 
inventory  based  (SID)  and  the  other  is  geographically  (spatially)  based 
(DAMCAL)  using  a  grid  cell  data  bank.  The  subsequent  elevation-damage 
function  development  capability  is  virtually  identical  for  both.  Damage 
functions  may  be  developed  by  reach,  by  damage  category  and  for  a  wide  range 
of  non-structural  flood  plain  management  measures.  References  are  available 
describing  an  overview  of  spatial  versus  inventory  approach  (4),  guidance  on 
preparation  of  grid  cell  data  banks  (7),  and  examples  of  the  application  in 
Corps  studies  (14).  Other  analysis  features  are  available  for  hydrologic  and 
economic  aspects  of  studies  using  the  spatial  approach  but  are  not  discussed 
herein.  Reference  (6)  is  a  descriptive  overview  of  the  spatially-based  HEC- 
SAM  system.  Regardless  of  the  approach  taken  the  program  (SID  or  DAMCAL)  is 
executed  for  the  without  condition  and  then  with  alternatives  of  interest  and 
the  computed  results  written  to  the  DSS  file  with  the  appropriate  identifying 
labels.  The  user's  manuals  for  SID  and  DAMCAL  describe  their  specific 
capabilities  and  provide  instructions  for  their  use. 

The  SIDEOT  program  is  a  specially  designed  editor  that  can  manipulate  the 
structure  inventory  data  file  that  would  be  developed  for  use  with  SID.  It 
has  capabilities  to  enable  easy  data  editing  to  correct  errors,  updating  by 
any  number  of  mathematical  operations  and  windowing  out  data  sets  for  a  more 
geographically  confined  analysis. 

These  programs  are  generally  considered  to  be  intermediate  steps  to  annual 
damage  computations  but  the  careful  analyst  can  develop  very  useful  plan 


formulation/evaluation  data  as  a  by  product  to  development  of  the  elevation 
damage  functions.  For  example,  the  analyst  could  compute  such  data  as  the 
damage  resulting  from  specific  frequency- flood  events  and  the  number  of 
inundated  structures  (or  acres  of  land)  by  category  and  flood  frequency  zone 
using  either  SIO  or  OAMCAL. 

4.  Expected  Annual  Damage  Computations 

At  this  point,  the  DSS  file  contains  flow-exceedance  frequency,  elevation 
flow  rating,  and  elevation-damage  potential  data  for  a  variety  of  conditions 
and  alternatives.  The  final  step  to  compute  expected  annual  damage  is  the 
execution  of  the  EAD  program  for  the  specific  conditions  and  alternatives 
desired.  The  EAO  program  is  executed  conventionally  except  that  instead  of 
defining  each  of  the  various  relationships  in  an  input  data  file,  the 
appropriate  data  is  retrieved  from  the  DSS  file  by  recalling  data  sets  with 
the  appropriate  identifying  labels.  In  effect  the  annual  damage  computations 
are  performed  by  orchestrating  the  data  from  the  DSS  file  into  groupings 
needed  for  the  alternative  evaluation. 

D.  Typical  Applications  of  the  Package 

Various  components  of  the  package  come  into  play  for  specific  types  of 
analysis.  Selected  evaluation  situations  are  described  below  to  provide  the 
reader  with  the  flavor  of  the  significant  capability  that  the  integrated 
package  provides.  Assume  for  this  discussion  that  basic  computer  runs  have 
been  made  so  that  the  DSS  file  contains  base  condition  evaluation  data  of 
flow-frequency,  elevation-flow,  and  elevation-damage  for  locations  of  interest 
within  an  area  under  investigation.  Several  alternate  watershed  conditions 
and  alternative  flood  damage  mitigation  measures  will  be  evaluated. 

1 .  Future  Watershed  Urbanization 

Increased  urban  development  in  a  watershed  can  have  a  direct  effect  on 
storm  runoff.  To  evaluate  future  runoff  impacts,  HBC-1  is  executed  in  the 
multi-plan  mode  with  runoff  and  routing  coefficients  representative  of  both 
the  base  condition  and  projected  future  conditions.  The  resulting  sets  of 
flow-exceedance  frequency  data  are  written  to  the  DSS  file.  The  coefficients 
for  existing  and  future  conditions  are  developed  conventionally  through  study 
of  historic  storms,  or  through  the  use  of  a  grid  cell  data  bank  -  see 
references  (7)  and  (1)  for  details.  The  EAD  program  is  executed,  if  desired, 
to  determine  the  effect  of  future  urban  development  on  annual  damage  by 
retrieving  the  future  condition  frequency  curves  along  with  the  other  base 
condition  data  rather  than  the  base  condition  frequency  data. 

2.  Storage  Reservoirs 

Storage  reservoirs  for  flood  control  are  of  two  types  -  uncontrolled 
(sometimes  referred  to  as  "ungated")  where  outflow  is  a  function  of  storage  in 
the  reservoir;  and  controlled  (sometimes  referred  to  as  "gated")  wherein 
reservoir  releases  are  made  based  on  downstream  flow  conditions.  In  the 
former  case,  the  simple  uncontrolled  reservoirs  to  be  studied  are 
characterized  by  storage-outflow  routing  functions  and  these  are  inserted  into 
the  HEC-1  data  set.  HEC-1  is  executed  and  the  resulting  regulated  flow- 
frequency  data  are  written  to  the  OSS  file.  In  the  latter  (gated  case), 
inflow  data  for  HEC-5  is  derived  by  alternate  means,  or  HEC-1  is  executed  to 


develop  a  set  of  inflow  hydrographs  using  an  HEC-1  run  set-up  similar  to  that 
needed  for  the  ungated  analysis,  except  that  hydrographs  are  written  to  the 
DSS  file.  HEC-5  is  then  executed,  retrieving  the  flow  hydrographs  from  the 
DSS  file  and  performing  a  simulation  analysis  for  the  proposed  storage 
reservoirs.  The  resulting  flow-frequency  data  are  written  to  the  DSS  file. 

These  regulated  frequency  curves,  along  with  appropriate  rating  and  damage 
functions,  are  then  retrieved  by  the  EAD  program  to  determine  the  reduction  in 
annual  damage  due  to  the  storage  reservoirs.  Detailed  guidance  for  performing 
the  modeling  needed  to  evaluate  reservoirs  is  contained  in  the  HEC-1  and  HEC-5 
user  manuals. 

3.  Flood  Plain  Management  Actions  and  Policies 

Mitigation  measures  that  modify  the  damage  potential  of  flood  plain 
occupant  properties  are  evaluated  with  SID  and  DAMCAL  -  the  specific  program 
used  depends  on  whether  spatial  data  or  structure  inventory  data  are  used. 
SIDEDT  is  used  to  "window"  a  larger  structure  data  set  to  a  smaller  subset  if 
a  subunit  of  the  study  area  is  to  be  investigated.  It  is  also  used  to  correct 
and  update  data  contained  in  a  SID  file  to  represent  the  conditions  of 
interest . 

The  SID  (or  DAMCAL)  programs  are  then  executed  for  the  mitigation  measures 
of  interest  (flood  proofing,  relocation,  temporary  emergency  action, 
management  of  future  development)  and  the  resulting  elevation-damage  data 
written  to  the  DSS  file.  The  EAD  program  is  then  executed,  if  desired,  to 
determine  the  annual  damage  reduction  resulting  from  the  proposed  measures. 

The  full  range  of  these  program  capabilities  are  contained  in  their  respective 
user's  manuals  (references  12  and  2). 

4.  Channel  and  Levees 

Channel  modifications  directly  impact  on  the  geometry  of  the  stream 
conveyance  system.  The  HEC  water  surface  profiles  program  is  therefore  the 
evaluation  tool.  HEC-2  runs  are  made  for  the  alternatives  of  interest, 
whether  clearing  and  snagging  (smoothing  roughness)  or  channel  enlargement  or 
straightening  or  both  and  the  resulting  multiple  profile  data  are  written  to 
the  DSS  file.  If  levees  are  studied,  and  their  placement  adjacent  to  the 
stream  results  in  a  measurable  reduction  in  conveyance,  HEC-2  runs  are  made 
for  these  cases  as  well  and  the  resulting  altered  profile  data  written  to  the 
DSS  file.  The  EAD  program  is  then  used  to  retrieve  appropriate  rating 
functions  and  other  data  to  compute  the  annual  damage  reduction  that  would 
result  from  the  measures.  Evaluation  of  levees  alone  are  often  satisfactorily 
analyzed  by  adjustment  of  functions  (truncation  of  damage  or  frequency 
functions)  at  the  time  of  EAD  execution  and  thus  need  not  require  re-analysis 
with  other  programs. 


IV.  study  Management 


A.  Organizational  Matters 

Studies  that  are  intended  to  realize  the  full  potential  of  the  Flood 
Damage  Analysis  (FDA)  package  need  to  be  particularly  careful  to  ensure 
coordination  among  participating  study  group  members  with  respect  to  common 
data  sets,  elevation  datum,  study  area  partitioning,  alternatives  to  be 
considered,  and  naming  conventions.  Study  management  and  the  participating 
technical  analysts  should  meet  early  (and  often)  to  adopt  the  necessary  common 
items.  Most  often,  study  participants  will  work  in  separate  District  units, 
and  to  a  significant  degree,  independent  of  others.  It  is  essential  that  the 
following  be  accomplished: 

1.  Assignment  of  responsibility  for  coordination  of  data  management 
activities.  This  can  be  performed  by  any  element  but  can  usually  best 
be  accomplished  by  the  staff  of  the  coordinating  unit  -  usually  a 
technical  assistant  to  the  study  manager. 

2.  Agreement  on  those  items  that  must  be  coordinated  (e.g.  damage 
reaches,  index  locations,  stage/elevation  datum,  reporting 
subdivisions,  naming  conventions,  etc.)  and  the  mechanism  for  ensuring 
agreement . 

3.  Performance  of  first-pass  coordination  on  key  items  to  enable  study 
activities  to  begin. 

4.  Development  of  a  phased  work  plan  schedule  for  each  participant  to 
permit  orderly  progression  of  computer  processing  that  is  dependent 
upon  data  in  computer  files  to  be  developed  by  others. 

B.  Computer  Program/File  Management 

The  FDA  package  programs  should  all  exist  on  a  single  computer  system  so 
that  files  may  be  written  in  a  straight-forward  manner.  The  programs  must  be 
the  proper  versions;  e.g.  Districts  with  versions  of  HEC-1,  HEC-2  etc.  that 
do  not  contain  the  DSS  software  system  calls  will  not  be  able  to  write  data  to 
DSS  files.  Recent  HEC  official  library  versions  resident  on  the  Harris  500 
(or  1000)  and  the  CDC  Cybernet  systems  have  the  necessary  features 
incorporated.  Other  program  versions  may  not.  It  is  prudent  to  arrange  for 
acquisition/testing  of  the  needed  programs  early,  and  to  work  closely  with 
District  ADP  elements  to  ensure  availability  of  needed  hardware  and  dedicated 
system  file  space  (e.g.  disc  storage  space).  The  features  of  the  programs 
that  make  them  linkable  through  the  DSS  system  are  significant.  If  a  District 
wishes  to  use  their  own  version  of  one  of  the  programs  that  had  been  modified 
to  accommodate  local  District  practices,  the  incorporation  of  the  DSS  features 
could  be  a  major  and  difficult  task.  It  would  be  best  to  acquire  the  official 
HEC  library  program  with  the  DSS  features  already  incorporated  and  then  add, 
at  the  District  level,  the  local  modifications  as  needed. 

Efficient  use  of  the  FDA  package  (or  the  HEC  programs  independent  of  the 
FDA  features  for  that  matter)  requires  experienced  program  users.  Novices 
should  be  trained  In  the  basic  use  and  capabilities  of  the  Individual  programs 
(through  In-house  or  other  training  mechanisms)  and  then  Introduced  to  the 
more  advanced  Integrated  use  made  available  through  the  FDA  package.  Technical 


assistance  from  HEC  staff  may  be  useful  for  early  aspects  of  studies.  Several 
Districts  have  made  use  of  the  capability  and  are  likewise  valuable  contacts 
for  ideas  regarding  the  FDA  package,  (for  example.  New  York,  Ft.  Worth,  St. 
Louis,  and  Little  Rock). 

C.  Data  Management 

Planning  studies  which  make  significant  use  of  computerized  analysis  are 
the  rule  rather  than  the  exception  within  the  Corps  of  Engineers.  Planning 
studies,  by  their  increasingly  comprehensive  nature,  involve  several  District 
elements.  Assignments  change  and  staff  change  positions.  Studies  that  use 
the  FDA  Package  depend  upon  data  placed  in  computer  files  by  the  several 
District  elements.  It  is  therefore  important  that  each  element  be 
businesslike  in  recording  at  regular  intervals  in  notebooks/study  files,  the 
status  of  computer  runs,  location  and  conditions  for  which  files  were  written 
to  the  DSS  file,  and  any  notations  needed  to  enable  the  "next  person"  to 
continue  the  study  from  that  point  with  minimum  disruption.  File  management 
and  archiving  for  future  reference  are  also  important. 

Another  common  tendency  in  the  present  highly-computerized  environment  of 
studies  is  to  concentrate  on  making  computer  runs  and  obtaining  output  and 
files  to  the  neglect  of  narrative  documentation  of  important  assumptions,  data 
adjustment,  and  insights  obtained.  It  is  a  useful  practice  to  prepare 
regularly  (along  with  the  recording  of  the  status  of  computer  data  and  runs 
described  separately)  narrative  descriptions  of  these  aspects  of  the  study  so 
that  they  likewise  may  provide  for  continuity  of  study  progress  should 
interruptions  occur.  Even  without  application  of  the  FDA  package,  business¬ 
like  during-study  documentation  discussed  herein  is  a  good  idea. 
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A.  Data  Management 


1.  Introduction 

This  appendix  describes  data  manipulations  when  using  the  previously 
mentioned  programs  as  a  package.  The  traditional  manner  of  performing  a  study 
is  to  prepare  data  input  to  a  specific  applications  program  in  a  single, 
human-readable  file,  execute  the  program,  obtain  computed  results  printed  on 
paper,  and  then  prepare  data  input  in  another-human  readable  file  to  another 
applications  program  that  utilizes  computed  results  from  the  first  program. 
This  method  requires  the  user  to  manually  read  results  from  printed  output  and 
enter  them  as  input.  This  method  has  the  following  disadvantages  and 
advantages : 

o  Disadvantages: 

o  The  user  can  easily  make  an  error  in  transferring  the  data. 

o  The  user  might  have  to  expend  considerable  time  and  energy  to  transfer 

the  data. 

o  Advantages : 

o  The  user  need  not  have  any  knowledge  of  a  data  management  system. 

o  The  user  does  not  need  data  management  software.  Data  management 

software  are  generally  more  computer  system  dependent  than  the 
application  programs  and  thus  may  not  be  as  available. 

When  using  the  Flood  Damage  Analysis  programs  as  a  package,  the  user  must 
still  prepare  data  input  in  a  human  readable  file  and  obtain  printed  output. 
However,  some  input  normally  entered  by  the  user  may  be  retrieved  from  a  data 
base  file  and  some  output  that  is  printed  may  also  be  written  to  that  file. 
This  reduces  the  amount  of  user  input  and  allows  the  user  to  retain  computed 
results  on  a  computer  system  and  subsequently  view  and  rompare  alternatives. 
HEC  has  developed  a  data  storage  system  (DSS)  that  allows  the  user  to  transfer 
data  between  programs,  has  modified  the  application  programs  to  utilize  it, 
and  has  developed  utility  programs  to  manipulate  DSS  data  files.  To  take 
advantage  of  DSS,  the  user  will  need  to  make  minor  modifications  to  the  job 
control  language  (JCL)  used  to  execute  the  program  and  to  the  input  data 
files.  These  modifications  are  described  in  detail  later  in  this  section  under 
"Application  Programs". 

2.  DSS  Description 

DSS  is  a  collection  of  subroutines  that  can  be  called  by  application 
programs  (such  as  HEC-1).  The  programs  retrieve  from  the  DSS  software  or  pass 
to  the  DSS  software  some  kind  of  data  and  associated  descriptors.  DSS  in  turn 
accesses  a  disk  file  and  either  retrieves  data  from  or  stores  data  in  that 
file.  The  data  file  remains  permanently  on  the  computer  system  until  saved  on 
tape  and  eliminated  by  the  user.  The  user  can  access  data  in  that  file  by 
executing  an  applications  program  (such  as  EAD)  that  will  read  data  from  it, 
or  by  executing  a  DSS  utility  program  (such  as  DSPLAT)  that  can  tabulate  or 
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plot  data  from  it.  The  description  contained  herein  is  very  general.  The  user 
may  obtain  more  detailed  information  on  the  DSS  and  its  utilities  from 
reference  (8). 


DSS  utilizes  a  direct  access  (versus  sequential)  disk  file.  A  direct 
access  file  permits  more  efficient  data  access  than  a  sequential  file  when 
used  in  a  data  management  environment.  The  fact  that  the  DSS  file  is  a  direct 
access  file  is  important  to  the  user  for  two  reasons; 

o  The  data  stored  in  the  file  is  not  stored  in  a  human  readable  format 

-  the  user  cannot  "list"  the  file  but  must  execute  a  program  to  look 

at  the  data. 

o  The  user  may  have  to  create  the  DSS  file  in  a  special  way  —  this  is 
computer  system  dependent  and  will  be  addressed  later  under 
Application  Programs. 

A  DSS  file  stores  data  by  records.  It  may  contain  only  one  record  or  as 
many  records  as  the  user  wishes.  A  unique  alphanumeric  string  of  80  or  fewer 
characters  identifies  each  record.  This  identifier  is  referred  to  as  a 
"pathname".  There  is  one  pathname  for  every  record  and  no  two  pathnames  can  be 
identical.  The  pathname  begins  and  ends  with  the  slash  ("/")  character  and 
consists  of  six  parts,  each  separated  by  a  slash  ("/").  For  discussion 
purposes,  the  parts  will  be  identified  as  A,B,C,D,E,  and  F.  Thus,  a  possible 
pathname  would  be: 


/A/B/C/D/E/F/ 


In  practice,  pathname  parts  follow  certain  naming  conventions  as  shown  below: 


Pathname 

Part  Description 


A  River  basin  or  Project  identifier. 

B  Location,  reach,  or  gage  identifier. 

C  Data  variable  or  variables  (i.e.  FLOW). 

E  Year  corresponding  to  data  (for  Flood  Damage 

Analysis) . 

F  Alternative  name  or  data  variable  qualifier. 


For  instance,  if  HEC-1  was  executed  to  compute  a  flow-frequency  curve  for  two 
plans  and  those  curves  were  stored  in  a  DSS  file,  the  resulting  pathnames  for 
these  curves  might  look  like  this: 


/SILVER  CREEK/RCH  1/FREQ-FLOW//1980/BASE/ 

/SILVER  CREEK/RCH  1/FREQ-FLOW//1980/UNGTD  RES/ 

DSS  data  records  internally  follow  certain  conventions.  They  include 
regular  time  series,  irregular  time  series,  and  paired  function  data.  The  user 
need  not  know  much  of  anything  about  these  conventions  other  than  that  they 
exist.  To  perform  flood  damage  analysis,  the  user  need  utilize  only  the  paired 
function  convention.  Paired  data  is  data  that  represents  a  two  variable 
relationship.  The  relationships  used  in  flood  damage  analysis  include:  flow- 
frequency,  stage-discharge,  and  stage-damage.  One  or  more  paired  data  curves 
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may  be  stored  in  a  single  DSS  record.  However,  each  record  contains  data  for 
only  one  location,  one  alternative  or  plan,  and  one  point  in  time  (year).  A 
record  may  contain  more  than  one  curve  if  one  variable  has  a  single  set  of 
ordinates.  SID  and  DAMCAL  are  the  only  Flood  Damage  Analysis  programs  that 
store  multiple  curves  in  a  single  DSS  record.  They  generate  stage-damage 
curves  where,  for  a  single  set  of  stages,  there  might  be  several  corresponding 
sets  of  damage  values  such  as  residential,  light  commercial,  and  heavy 
commercial . 

The  regular  time  series  convention  is  not  required  for  the  flood  damage 
analysis  package  but  may  be  beneficial  to  the  user  in  the  application  of  HEC-1 
or  HEC-5.  This  convention  is  used  to  store  hydrographs  containing  ordinates 
spaced  uniformly  in  time.  Thus,  the  user  could  store  and  compare  flood 
hydrographs  for  several  plans  for  each  ratio. 

Each  DSS  record  is  comprised  of  two  parts:  a  header  and  a  data  area. 

The  data  area  contains  application  program  input  or  output  such  as  flow 
hydrographs  or  paired  functions.  The  header  part  contains  index  or  descriptive 
information  for  the  data.  This  includes  such  things  as  the  data  units  (CFS, 
FEET,  ...),  data  type  (average  for  the  period,  instantaneous,  or 
probabilistic),  and  the  number  of  values  or  ordinates. 

When  using  the  Flood  Damage  Analysis  Package,  the  user  must  maintain 
the  integrity  of  the  DSS  data  file.  As  with  any  other  file,  it  can  be  damaged 
by  a  computer  system  crash,  a  user  directed  application  program  abort,  or  an 
involuntary  application  program  abort.  File  integrity  is  maintained  by 
software  within  the  DSS  system  and  by  the  user  maintaining  backup  files.  DSS 
software  performs  file  pointer  cleanup  when  an  application  program  aborts. 
Under  some  conditions,  a  computer  system  crash  may  irreparably  damage  a  DSS 
file  and  require  that  the  user  generate  a  new  file  from  a  backup  file. 

Any  analysis  will  require  archiving  study  materials.  Computer  files  may 
be  archived  in  conjunction  with  normal,  periodic  system  backup  by  ADP  support 
personnel  or  as  a  result  of  specific  user  instruction.  It  usually  involves 
storing  data  on  a  low  cost,  mass  storage  device  such  as  a  magnetic  tape.  The 
tape  may  be  written  in  different  formats  ranging  from  very  efficient  but 
computer  system  dependent  to  less  efficient  but  computer  system  independent. 
Application  program  input  data,  program  source  code,  and  output  may  be  stored 
in  any  of  the  above  formats.  However,  application  program  executables  and  DSS 
data  files  may  only  be  stored  in  a  computer  system  dependent  format.  If  the 
user  anticipates  archiving  data  that  will  be  subsequently  transferred  to  a 
different  system,  the  data  and  source  codes  must  be  selectively  stored.  A  OSS 
file  can  be  recreated  on  another  computer  system  by: 

o  Either  re-running  all  application  programs  on  that  system. 

o  Or  creating  human  readable  system  independent  files  of  data  to 
transfer  between  systems. 

The  creation  of  a  system  transferable  file  requires  the  use  of  the  DSS  utility 
program  DSSUTL  (8)  to  retrieve  data  from  a  OSS  file  on  the  original  system  and 
store  it  in  a  transferable  file.  That  file  is  then  transferred  to  the  new 
system  and  DSSUTL  is  used  to  recreate  the  OSS  file  on  that  system.  The  user 
should  consult  his  support  personnel  for  help  in  archiving  data  on  magnetic 
tape.  Documentation  for  OSS  describes  the  use  of  DSSUTL  in  detail. 
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3.  Application  Programs 


a.  Description 

Flood  Damage  Analysis  application  rrograms  communicate  with  each  other 
through  a  DSS  data  file.  For  example,  EAD  uses  frequency  curves  computed  by 
HEC-1.  EAD  retrieves  those  curves  by  knowing  the  identification  of  the  data 
record  in  the  DSS  file  and  the  format  of  the  frequency  curve  data.  Some  of 
this  information  is  transparent  to  the  user  whereas  some  information  must  be 
supplied  by  the  user.  If  the  user  supplies  incorrect  information,  the 
application  program  will  not  obtain  the  required  data  and  will  compute 
erroneous  results.  This  section  will  describe  the  specific  user  actions 
required  to  successfully  utilize  the  DSS  linkage. 

EAD  is  the  "bottom  line"  application  program.  It  produces  the  user's  final 

objective  -  either  damage  for  a  specific  event  or  expected  annual  damage. 

EAD  processes  computed  results  from  one  or  more  of  the  following  programs: 
HEC-1,  HEC-2,  HEC-5,  SID,  and  DAMCAL.  Thus,  when  using  the  DSS  link,  EAD  can 
be  executed  only  after  at  least  one  of  these  other  programs  has  been  executed. 
For  most  applications,  the  programs  HEC-1,  HBC-2,  HEC-5,  SID,  and  DAMCAL  can 
be  executed  independently  and  in  any  order.  There  are  always  exceptions.  For 
example,  significant  channel  modifications  may  change  the  stage-discharge 
rating  curve  (HEC-2),  the  storage  routing  coefficients  (HEC-2  results  must  be 
used  in  HEC-1),  and  the  flow-frequency  curve  (HEC-1).  The  user  may  also  wish 
to  use  the  HTDPAR  (9)  program  to  develop  parameters  which  would  be  stored  in  a 
DSS  file  and  used  as  input  to  HEC-1.  In  that  case,  the  order  of  program 

execution  is  important  -  HEC-2,  followed  by  HYDPAR,  followed  by  HEC-1, 

followed  by  EAD. 

To  utilize  DSS,  the  user  must  execute  the  following  tasks: 

1.  Generate  the  DSS  file.  If  the  file  does  not  exist,  the  application 
programs  will  generate  it  using  default  specifications.  It  is 
necessary  to  generate  only  one  OSS  file  although  it  is  sometimes 
helpfull  to  use  more  than  one  file. 

2.  Modify  job  control  language  (JCL)  to  connect  the  DSS  file  to  the 
execution  of  a  desired  program  and  the  user's  input. 

3.  Enter  application  program  input  data  to  trigger  the  storage  or 
retrieval  of  data  from  a  DSS  file. 

4.  Enter  application  program  input  data  to  define  the  DSS  record 
identification  (pathname)  for  the  desired  data. 

b.  Creating  a  DSS  file 

The  first  step  required  to  use  OSS  is  the  creation  of  a  DSS  file.  This  is 
a  system  dependent  action.  The  users  main  goal  is  to  generate  a  DSS  file  in 
such  a  manner  that  will  maximize  data  integrity.  When  more  than  one  person 
will  use  the  file,  the  user  must  insure  that  cne  user  will  not  destroy  another 
user's  DSS  data.  The  following  recommendations  are  specific  to  Harris  and  CDC 
computers.  However,  the  concepts  can  be  applied  to  other  computers.  The  Harris 
computer  allows  multiple  users  to  simultaneously  access  the  same  file  whereas 
a  CDC  machine  allows  only  single  user  access. 
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o  To  generate  a  file  on  a  Harris  system: 

1.  If  only  one  user  at  a  time  will  access  the  file,  enter: 

$GEMERATE , filename , U 

This  creates  an  unblocked  file  called  "filename"  which  can  be 
accessed  by  only  one  user  at  a  time. 

2.  If  more  than  one  user  will  simultaneously  access  the  file,  enter: 

$GEMERATE , f i lename , R 

This  creates  a  direct  access  file  called  "filename"  which  can  be 
accessed  by  several  users  simultaneously. 

o  To  generate  a  file  on  a  COG  system,  the  user  should  enter: 

DEFINE, filename/M=W. 

This  creates  a  file  called  "filename"  with  write  access.  It  is  a 
direct  access  file  that  can  be  used  by  only  one  person  at  a  time. 

The  filename  should  be  three  through  seven  characters  starting  with  an  alpha 
character  (A  through  Z) .  Many  systems  allow  filenames  with  eight  characters, 
but  some  (like  COG)  limit  them  to  seven.  Also,  on  the  Harris,  the  DSS  system 
generates  a  file  that  inventories  the  data  file  pathnames.  This  file  is  called 
a  catalog  file.  Its  name  is  generated  by  appending  the  character  "G"  to  the 
name  of  the  data  file.  Thus,  if  the  data  filename  is  seven  characters,  the 
catalog  filename  is  eight  characters. 

c.  Accessing  a  DSS  File 

The  second  step  is  to  access  the  DSS  file  when  executing  an  applications 
program.  This  is  done  through  job  control  language  (JGL)  and  it  is  computer 
system  dependent.  When  created,  the  DSS  file  is  empty.  The  first  execution  of 
an  application  program  must  store  (write)  data  to  the  file  and  not  retrieve 
(read)  data. 

To  access  a  DSS  file  on  a  Harris:  perform  "file  substitution"  at  the  time 
of  execution.  For  example,  if  the  OSS  file  name  is  "SLVAAEZ",  the  user 
executes  HEG-1  by  entering: 

HLIB*HEG1X ,DSSF1LE=SLVAAEZ 

Unfortunately,  the  programs  are  not  consistent  in  their  use  of  a  file  name 
identifier.  Each  program  is  executed  with  DSS  file  access  by  using  the 
following  JGL  lines  where  "(filename)"  is  the  name  of  the  users  DSS  file: 

HLIB*HYDPAR , TAPE? 1= ( f i lename ) 

HLIB*HEC1X . DSSFILE= ( f i lename ) 

HLIB*HEC2X , OSSFILE= ( f i lename ) 

HLIB*HEC5BX , DSSOOT= (filename ) 
HLIB*SIDX,TAPE71=(filename) 
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HLIB*DAMCALX , TAPE7 1= ( f i lename ) 

HL IB*EADX , TAPE 7 1 = ( f i 1 ename ) 

The  user  may  determine  the  identifier  quite  easily  on  the  Harris.  For  example, 
to  determine  the  identifier  for  HEC-1,  the  user  would  type  the  following  on 
the  computer  terminal  keyboard: 

HLIB*HBC1X,? 

HEC-1  would  list  each  local  file  number  (FORTRAN  unit),  identifier,  and 
default  file  assignment  as  shown  below. 


HLIB*HEC1X,? 


DEFAULT  ASSIGNMENTS 


LFN 

KEYWORD 

D 

7 

INPUT 

*0 

6 

OUTPUT 

LO 

8 

PUNCH 

W8 

21 

TAPE21 

W1 

22 

TAPE22 

W2 

23 

TAPE23 

U3 

24 

TAPE24 

W4 

25 

TAPE25 

W5 

32 

TAPE32 

U2 

33 

TAPE33 

U3 

34 

TAPE34 

U4 

35 

TAPE35 

U5 

36 

TAPE36 

U6 

38 

TAPE38 

U8 

71 

DSSFILE 

U1 

The  user  would  find  the  local  file  number  71  or  LFN  71  (except  for  HEC-5  which 
uses  72)  and  then  find  the  corresponding  identifier  to  use  in  the  execution 
JCL  (it  would  be  either  TAPE71,  DSSFILE,  or  DSSOUT) . 


To  access  a  OSS  file  on  a  CDC  machine,  the  user  may  either  perform  file 
substitution  or  make  a  file  assignment.  File  substitution  requires  the  user  to 
know  the  order  of  file  declarations  on  the  program  card  within  the  FORTRAN 
source  code.  This  information  may  be  difficult  to  obtain.  Thus,  the  user  is 
encouraged  to  use  the  second  method  of  accessing  a  DSS  file  as  described 
below.  All  programs  utilize  Fortran  unit  71  for  the  DSS  file  except  HEC-5 
which  stores  data  on  unit  72.  In  JCL,  unit  71  is  identified  as  "TAPE71'’.  To 
access  the  DSS  file,  the  user  would  assign  that  unit  before  executing  that 
program.  For  example,  to  access  the  OSS  file  "SLVAABZ",  the  user  would  enter: 

ATTACH , TAPE7 l=SLVAAEZ/MsW. 
or  ATTACH, TAPE71=SLVAAEZ. 

The  inclusion  of  *VM=W"  allows  the  user  to  write  data  to  the  file  and  it  may 
be  eliminated  if  the  user  is  only  reading  data  from  the  file. 
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Example  JCL  files  are  listed  below: 


1.  Harris  -  JCL  and  input  data  stored  in  same  file: 

$J0B,HEC1 . 

HLIB*HEC1X , DSSFILE=SLVAAE2 
(HEC-1  input  data) 


$EOJ 


2.  Harris  -  Input  data  stored  in  a  separate  file  (called  SLVAOlI)  from 

JCL: 


JJOB.HECl, . 

HLIB*HEC1X, INPUT=SLVAOir ,DSSFILE=SLVAAEZ 
$EOJ 


3.  CDC  Cybernet  -  JCL  and  input  data  stored  in  same  file: 

HEC,CM377000,P=3.T=70. 

USER , CEL7XX .password , KOE . 

CHARGE , CEL7XXX , xxxxx . 

GET , HEC1/UN=CECELB . 

ATTACH , TAPE7 1 =SLVAAEZ/M=W . 

HECl. 

/*EOR 

(HEC-1  input  data) 


/*EOF 


4.  CDC  Cybernet  -  Input  data  stored  in  a  separate  file  (called  SLVAOlI) 

from  JCL: 


HEC , CM3  7  7000 , P=3 , T=70 . 

USER , CEL7xx , password , KOE . 
CHARGE , CEL7XXX , xxxxx . 

GET , HECl /UM=CECELB . 

ATTACH ,TAPE71=SLVAAEZ/M=W. 
GET, SLVAOlI. 

HECl, SLVAOlI. 

/*EOF 


I 


24 


Appendix  A 


d.  JCL  and  Data  Modifications 

The  next  steps  require  the  user  to  enter  certain  application  program  input 
data  that  will  trigger  a  read  or  write  of  data  to  a  DSS  file  and  specify  the 
desired  record  identifier  (called  pathname).  The  user  triggers  a  retrieval  (or 
read)  from  DSS  file  by  entering  one  or  more  ”ZR"  cards.  The  "ZR"  refers  to  the 
card  code  identifier  that  is  entered  in  columns  one  and  two  of  a  data  input 
record.  Similarly,  the  user  triggers  a  storage  (or  write)  to  DSS  file 
operation  by  entering  one  or  more  ”ZW"  cards.  Dser  input  on  the  ZR  and  ZU 
cards  define  some  parts  of  the  DSS  pathname,  but  not  all.  The  user  must 
generally  define  parts  A,  E,  and  F  on  the  ZR/ZW  cards.  As  mentioned  earlier, 
part  A  defines  the  Basin  or  River,  E  the  year  that  the  data  represents,  and  F 
the  alternative  or  plan  identification.  When  defining  parts,  leading  and 
trailing  blanks  are  ignored  and  embedded  blanks  are  significant. 

For  Flood  Damage  Analysis,  part  A  will  be  identical  for  all  application 
programs  for  a  given  study  area.  Each  plan  will  have  an  identical  F  pathname 
part,  and  each  data  year  will  have  an  identical  E  pathname  part.  Input  to  each 
program  will  be  discussed  in  more  detail  below.  However,  it  would  be  helpful 
to  show  one  example. 

For  the  HEC-1  economic  analysis  mode,  the  ZU  card  defines  parts  A,E,  and  F 
of  the  pathname.  Part  A  is  entered  in  columns  three  through  sixteen,  part  E  in 
columns  forty-five  through  forty-eight,  and  part  F  in  columns  seventeen 
through  forty.  For  discussion  purposes,  assume  a  study  is  being  performed  in 
"Bedrock  Creek"  for  the  plan  "Base",  and  for  the  year  1980.  HEC-1  writes 
frequency  curves  to  OSS  and  EAD  will  later  read  those  curves.  Pathname  parts 
entered  on  the  ZW  card  for  HEC-1  will  have  to  be  exactly  duplicated  on  the  ZR 
card  for  EAD.  It  so  happens  that  the  ZR  card  for  EAD  contains  pathname  part  A 
in  columns  three  through  sixteen,  and  part  F  in  columns  seventeen  through 
forty.  Examples  below  depict  user  input  which  would  trigger  DSS  interaction. 


Valid  example: 

ZW  SILVER  CREEK  BASE  1980 

ZR  SILVER  CREEK  BASE  QF  1 

BAD  will  be  able  to  read  frequency  curves  written  to  OSS  by  HEC-1  because 
leading  and  trailing  blanks  of  a  pathname  part  are  ignored.  OSS  software  will 
ignore  the  leading  blank  before  "SILVER  CREEK"  on  the  ZW  card  and  the  leading 
blanks  before  "BASE"  on  the  ZR  card. 

Invalid  example: 

ZWSILVER  CREEK  BASE  1980 

ZRSILVER  CREEK  BASE  QF  1 
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EAD  will  not  be  able  to  retrieve  the  frequency  curve  written  by  HEC-1  for 
two  reasons: 

o  The  HEC-1  ZW  card  contains  two  blank  columns  between  "SILVER”  and 
"CREEK"  whereas  the  EAD  ZR  card  contains  only  one. 


o  The  HEC-1  ZW  card  contains  the  year  ”1980”  outside  of  the  required 
columns  forty-five  through  forty-eight. 


The  users  manuals  for  programs  HEC-1,  HEC-5,  HYDPAR,  SID,  and  EAD  describe  DSS 
input  data  cards  ZR  and  ZW.  Appendix  B  of  this  document  describes  DSS  input 
data  cards  for  the  programs  HEC-2  and  DAMCAL. 

Earlier  sections  of  this  document  describe  analysis  scenarios  and  the  type 
of  data  stored  in  or  retrieved  from  a  DSS  file  when  performing  Flood  Damage 
Analysis.  In  summary,  HEC-1  and  HEC-5  store  flow-frequency  curves,  HEC-  2 
stores  stage- discharge  curves,  SID  and  DAMCAL  store  stage-damage  curves,  and 
EAD  reads  all  of  these  curves.  Storage  of  computed  results  essentially 
duplicates  printed  output.  Retrieval  of  data  from  a  DSS  file  replaces  user 
input.  Thus,  the  user  may  associate  certain  EAD  input  cards  with  data  stored 
in  a  DSS  file.  This  association  for  EAD  is  described  later.  In  general,  the 
user  specifies  pathname  parts  A,  E,  and  F  on  the  ZR  and  ZW  cards.  The  other 
pathname  parts  may  be  either  automatically  generated  by  the  applications 
program  or  entered  by  the  user  as  a  normal  input  data  item  even  for  non  DSS 
jobs.  Table  2  summarizes  the  location  of  pathname  parts  entered  to  each 
program. 

A  pathname  cannot  exceed  80  characters  including  the  ”/”  (slash) 
separators.  DSS  limits  individual  parts  to  thirty-two  characters.  Application 
programs  further  limit  those  pathname  parts  by  allowing  a  limited  number  of 
columns  of  user  input.  As  a  result,  the  following  limitations  apply  to 
pathname  parts  when  used  in  Flood  Damage  Analysis: 


Maximum  number  of  characters 
14 
6 

4 
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TABLE  2:  Location  of  DSS  Pathname  Parts  (1) 


Pathname  Part 


A 

B 

C 

D 

E 

F 

Program 

HYDPAR 

ZW.1-2 

SB-5 

AG 

NA 

ZW.6 

ZW.3-5 

HEC-1 

ZW.1-2 

FR.1[21 

AG 

NA 

ZW.6 

ZW.3-5 

HEC-2 

2W.1-2 

XI.  1 

AG 

NA 

ZW.6 

ZW.3-5 

HEC-5 

ZW  [31 

ID. 1-2 

AG 

NA 

ZW  (31 

ZW  [31 

SID 

ZW.1-2 

DR.l 

AG 

NA 

ZW.6 

ZW.3-5 

DAMCAL 

ZW.1-2 

DT.  1 

AG 

NA 

ZW.6 

ZW.3-5 

EAD 

ZR.1-2 

[41 

AG  [51 

NA 

[6] 

ZR.3-5 

EAD 

ZR.1-2 

QF.l 

AG 

NA 

QF.2 

ZR.3-5 

EAD 

2H.1-2 

QS.  1 

AG 

NA 

QS.2 

ZR.3-5 

EAD 

2R.1-2 

DG.l 

AG 

NA 

DG.2 

ZR.3-5 

note; 

[11  The  part  location  is  identified  by  the  code: 

”xx . n-m" 
where: 

XX  is  the  card  code  identifier  entered  in  columns  one  and  two  for 
an  application  program  (i.e.  "ZW"). 

n-m  is  the  field  locations  on  that  card.  If  only  one  field  is 

occupied,  then  ’’-m"  is  not  entered.  Sometimes,  partial  fields 
are  used.  That  is  documented  with  the  detailed  card  descriptions. 

The  code  "NA"  indicates  that  part  is  not  used  and  the  code  "AG" 
indicates  that  part  is  automatically  generated  by  the  applications 
program. 

[2]  HEC-1  generates  part  B  from  field  one  of  the  FR  card.  If  it  is  blank, 
then  it  uses  the  first  field  of  the  preceding  KK  card. 

[3]  HEC-5  requires  the  user  to  enter  "ZWQF"  in  columns  one  through  four  to 
store  flow-frequency  data  in  a  DSS  file.  Parts  A,  E,  and  F  are 
entered  in  a  free  format  style.  For  example: 

ZWQF  A=BEDROCK  CREEK,  E=1990,  F=BASE 

(41  EAO  generates  part  B  from  field  one  of  the  following  cards:  QF,QS,DG. 
[5]  EAD  automatically  generates  part  C  based  on  the  type  of  card  input: 
QF,QS,  or  DG. 

[61  EAD  generates  part  E  from  field  2,  columns  nine  through  twelve  of  the 
following  cards:  QF,QS,  or  DG. 
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e.  Data  Link  to  the  EAD  Program 

User  input  which  triggers  DSS  interaction  is  most  critical  for  the  EAD 
program.  This  input  must  exactly  agree  with  that  previously  entered  for  the 
other  programs.  Therefore,  some  additional  discussion  of  this  link  is 
warranted.  It  is  organized  by  data  type.  Example  usage  is  included  with  each 
description . 


(1)  Flow-Frequency 

EAD  reads  flow- frequency  data  from  FR  and  QF  cards.  To  read  flow-  frequency 
data  from  DSS,  the  user  must  execute  either  HEC- 1  or  HEC-5: 

(la)  Execute  HEC-1.  For  example: 

HLIB*HEC1X,DSSF1LE=SLVAAEZ 

o  A  DSS  file  has  been  generated  and  attached  to  this  execution. 

For  example,  if  the  file  does  not  exist,  generate  it: 

$GE  SLVAAEZ  R  PR  PW  OD  G=100 

o  A  ZW  card  must  be  entered  after  the  EC  card  and  after  each  PN 
card . 

o  The  ZW  card  must  contain: 

o  Pathname  part  A  in  columns  three  through  sixteen. 

0  Pathname  part  F  in  columns  seventeen  through  forty, 

o  Pathname  part  E  in  columns  forty- five  through  forty-eight. 

o  Pathname  part  B  is  entered  on  each  FR  card  in  columns  three 
through  eight. 

o  Example  HEC-1  input; 

ID . 


EC 

PN  lEXI STING  CONDITIONS 

ZW  SILVER  CREEK  BASE 
PN  2UNGATE0  RESERVOIR 

ZW  SILVER  CREEK  UNGTD  RES 
KK  RCH  1 

FR  RCH  1  16  . 

QF  . 

ZZ 


1985 

1985 
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(lb)  Execute  HEC-5 


o  HEC-5  must  be  executed  in  two  parts.  Example  JCL  is: 
HLIB*HEC5AA 

HLIB*HEC5BX , DSS0UT=SLVAAE2 

o  DSS  file  is  generated  and  attached  to  this  execution.  For 
example,  if  the  file  does  not  exist,  generate  it: 

$GE  SLVAAEZ  R  PR  PW  OD  G=100 

o  Appropriate  flags  are  set  on  the  J4  card: 

o  A  positive  integer  is  entered  in  field  one  of  the  J4  card, 
o  A  "2'*  is  entered  in  field  ten  of  the  J4  card. 

o  A  ZW  card  is  entered  after  the  BF  and  FC  cards. 

o  The  ZW  card  contains: 

o  Pathname  part  A  in  free  format, 

o  Pathname  part  F  in  free  format, 

o  Pathname  part  E  in  free  format. 

o  Pathname  part  B  is  entered  on  each  ID  card  in  columns  three 
through  sixteen.  Only  six  characters  are  entered  for  flood 
damage  analysis. 

o  Example  HEC-S  input: 

T1 . 


J4  1  2 


CP  2  . 

ID  RCH  1 
RT  .... 

DA  .  . 

DF  .... 

DQ  .... 

DC  .  .  . 

ED 

BF  2  ...  . 

FC  .2  _ 

ZW  A=SILVER  CREEK  E=1985  P=GATED  RES 


EJ 

ER 
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(Ic)  Execute  EAD 


o  The  DSS  file  used  for  the  HBC-1  or  HEC-5  job  must  be  attached  to 
the  EAD  execution.  Example  JCL  is: 

HLIB*EADX,TAPE71=SLVAAE2 

o  A  ZR  card  must  be  entered  and  contain: 

o  Pathname  part  A  in  columns  three  through  sixteen, 

o  Pathname  part  F  in  columns  seventeen  through  forty, 

o  The  characters  "QF"  in  columns  forty-seven  and  forty-eight, 
o  A  numeric  plan  identifier  in  columns  fifty-five  and 
fifty-six  (right  justified), 
o  Example  EAD  input  for  ZR  cards: 

ZR  SILVER  CREEK  BASE  QF  1 

ZR  SILVER  CREEK  UNGTD  RES  QF  2 

ZR  SILVER  CREEK  GATED  RES  QF  3 

o  A  QF  card  must  be  entered  at  the  location  that  the  FR  and  QF 

cards  are  normally  entered.  The  QF  card  must  contain: 

o  Pathname  part  B  in  columns  three  through  eight  which  is 
identical  to  a  reach  identification  entered  either  in 
columns  three  through  eight  of  a  FR  card  in  the  economics 
section  of  the  HEC-1  data  deck  or  columns  three  through 
sixteen  of  an  ID  card  in  the  HEC-5  input  data  file. 

o  Pathname  part  E  in  columns  nine  through  twelve  which  is 
identical  to  that  entered  in  columns  forty-five  through 
forty-eight  of  the  HEC-1  ZW  card  or  on  the  HEC-5  ZW  card. 

o  The  plan  number  in  columns  thirteen  and  fourteen  (right 

justified).  This  must  agree  with  the  plan  number  entered  on 
a  ZR  card. 

o  "-1"  in  columns  twenty-three  and  twenty-four  to  instruct 
EAD  to  read  the  flow-frequency  curve  from  a  DSS  file. 


Example 

EAD  input  data: 

ZR  SILVER  CREEK 

BASE 

QF 

1 

ZR  SILVER  CREEK 

UNGTD  RES 

QF 

2 

ZR  SILVER  CREEK 

GATED  RES 

QF 

3 

RN 

FR  RCH 

1  . 

QF  RCH 

11985  1 

-1 

EP 

1 

QF  RCH 

11985  2 

-1 

BP 

2 

QF  RCH 

11985  3 

-1 

EJ  3 
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HEC-1,  HEC-5,  and  EAD  automatically  generate  pathname  part  C  to  be: 

"FREQ- FLOW" 

(2)  Elevation-Discharge  Data 

EAD  reads  elevation-discharge  rating  curves  from  SQ  and  QS  cards.  To  read 
elevation-discharge  data  from  OSS,  the  user  must: 

(la)  Execute  HEC-2.  Example  JCL  is: 

HLIB*HEC2X , DSSFILE=SLVAAEZ 

o  A  DSS  file  has  been  generated  and  attached  to  this  execution. 
For  example,  if  the  file  does  not  exist,  generate  it: 

$GE  SLVAAEZ  R  PR  PW  OD  G^lOO 

o  A  ZW  card  must  be  the  first  input  data  record. 

o  The  ZW  card  must  contain: 

o  Pathname  part  A  in  columns  three  through  sixteen, 

o  Pathname  part  F  in  columns  seventeen  through  forty, 

o  Pathname  part  E  in  columns  forty-five  through  forty-eight. 

o  Pathname  part  B  is  entered  on  every  XI  card  in  columns  three 
through  eight. 

o  Conditional  modifications  are  made  to  the  J2  and  J3  cards. 

o  Example  HEC-2  input  data: 

ZW  SILVER  CREEK  BASE  1985 

T1  .... 


XI  49.0 


(lb)  Execute  EAD 

o  The  OSS  file  used  for  the  HEC-2  job  must  be  attached  to  the  EAD 
execution.  An  example  execution  of  EAD  is: 

HLIB*EADX,TAPE71=SLVAAEZ 

o  A  ZR  card  must  be  entered  and  contain: 

o  Pathname  part  A  in  column  three  through  sixteen, 

o  Pathname  part  F  in  columns  seventeen  through  forty, 

o  The  characters  "QS”  in  columns  forty-seven  and  forty-eight, 
o  A  numeric  plan  identifier  in  columns  fifty-five  and 
fifty-six  (right  justified). 
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A  QS  card  must  be  entered  at  the  location  that  the  QS  and  SQ 
cards  are  normally  entered.  The  QS  card  must  contain: 


o  Pathname  part  B  in  columns  three  through  eight  which 

corresponds  to  the  cross-section  number  entered  in  columns 
three  through  eight  of  a  XI  card  in  the  HEC-2  data  deck. 
HEC-2  stores  the  section  number  as  a  numeric  (as  opposed  to 
alpha)  quantity.  It  must  then  convert  that  numeric 
quantity  to  an  alpha  identification  when  used  as  part  B  of 
the  pathname.  This  conversion  process  may  slightly  alter 
what  the  user  has  input  on  the  XI  card.  For  example,  the 
section  number  ”32”  would  have  a  DSS  pathname  part  B  of 
"32.”. 

o  Pathname  part  E  in  columns  nine  through  twelve  which  is 
identical  to  that  entered  in  columns  forty-five  through 
forty- eight  of  the  HEC~2  ZW  card. 

o  A  numeric  plan  number  in  columns  thirteen  and  fourteen  that 
matches  columns  fifty-five  through  fifty-six  of  the  2R  card 
for  EAD. 

o  A  "-1”  in  columns  twenty-three  and  twenty-four  to  instruct 
EAD  to  read  the  elevation-discharge  curve  from  a  DSS  file. 

o  Example  EAD  input  data: 

TT 


ZR  SILVER  CREEK  BASE  QS  1 

ZR  SILVER  CREEK  CHIMP-20FT  BW  QS  5 

RN 

FR  RCH  1  . 

QF  RCH  11985  1  -1 

QS49. 0001985  1  -1 

EP  1 


QS49. 0001985  5  -1 

EJ  5 


HEC-2  and  EAD  automatically  generate  pathname  part  C  to  be:  "ELEV-PLOV". 
(3)  Elevation-Damage  Data 

EAD  reads  elevation-damage  relationships  from  SD  and  DC  cards.  These 
relationships  may  be  written  to  a  DSS  file  by  either  SID  or  DAMCAL.  They  are 
slightly  different  in  format  from  both  the  f low-frequency  and  elevation- 
discharge  curves,  elevation-damage  relationships  may  consist  of  several  curves 
identified  by  a  single  pathname  whereas  flow-frequency  and  elevation-discharge 
relationships  consist  of  a  single  curve  identified  by  a  single  pathname. 
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Elevation-damage  curves  correspond  to  damage  categories.  If  the  user  enters 
this  data  as  input,  he  would  enter  one  SD  card  followed  by  a  separate  DG  card 
for  each  category.  To  read  elevation-damage  data  from  a  DSS  file,  the  user 
would  enter  only  one  DG  card  to  retrieve  all  categories  (maximum  of  eighteen 
categories  allowed).  To  read  elevation-damage  data  from  DSS,  the  user  must: 


(la)  Execute  a  flood  damage  analysis  program  (either  SID  or  DAMCAL) . 
o  Execute  SID.  Example  JCL.  is: 

HLIB*SIDX , TAPE? 1 =SLVAAB2 

o  A  DSS  file  has  been  generated  and  attached  to  this 
execution.  For  example,  if  the  file  does  not  exist, 
generate  it: 

$GE  SLVAAEZ  R  PR  PW  OD  G=100 

o  A  ZW  card  must  be  included  and  contain: 

o  Pathname  part  A  in  columns  three  through  sixteen, 

o  Pathname  part  F  in  columns  seventeen  through  forty, 

o  Pathname  part  E  in  columns  forty-five  through 

forty-eight . 

o  Pathname  part  B  must  be  entered  on  every  DR  card  in  columns 
three  through  eight. 


u'-  . 

.V.V  1.'  V- 


o  Execute  DAMCAL.  Example  JCL  is: 

HLIB*DAMCALX , TAPE? 1 ^SLVAAEZ 

o  A  DSS  file  has  been  generated  and  attached  to  this 
execution.  For  example,  if  the  file  does  not  exist, 
generate  it: 


»*■*■'*'*■) 


$GE  SLVAAEZ  R  PR  PW  OD  G=100 


A  ZW  card  must  be  included  and  contain: 


o  Pathname  part  A  in  columns  three  through  sixteen, 

o  Pathname  part  F  in  columns  seventeen  through  forty. 

'>  Pathname  part  E  in  columns  forty-five  through 

forty-eight . 

Pathname  part  B  must  be  entered  on  every  DT  card  in  columns 
three  through  eight. 


Example  input  data  for  SID  (DAMCAL  is  very  similiar): 
T1  .  .  . 


ZW  SILVER  CREEK  BASE 
DF  .... 
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/  A. 


DR  RCH  1 
DT  .... 
SL  .... 
SD  .... 

ES 


(lb)  Execute  EAD 

o  The  DSS  file  used  for  either  the  SID  or  DAHCAL  job  must  be 
attached  to  the  EAD  execution.  Example  JCL  is: 

HLIB*EADX.TAPE71=SLVAAE2 

o  A  ZR  card  must  be  entered  and  contain: 

o  Pathname  part  A  in  columns  three  through  sixteen, 

o  Pathname  part  F  in  columns  seventeen  through  forty, 

o  A  numeric  plan  identifier  in  columns  fifty-five  and 
fifty-six  (right  justified). 

o  A  DG  card  must  be  entered  at  the  location  that  the  SD  and  DG 
cards  are  normally  entered.  The  DG  card  must  contain: 

o  Pathname  part  B  in  columns  three  through  eight  which  is 

identical  to  a  reach  identification  code  entered  in  columns 
three  through  eight  of  a  DR  card  in  the  SID  input  data 
deck  or  columns  3  through  8  of  a  DT  card  in  a  DAMCAL  input 
data  deck. 

o  Pathname  part  E  in  columns  nine  through  twelve  which  is 
identical  to  that  entered  in  columns  forty-five  through 
forty-eight  of  the  SID  ZW  card  or  DAMCAL  ZW  card. 

o  A  numeric  plan  number  in  columns  thirteen  and  fourteen  that 
matches  columns  fifty-five  and  fifty-six  of  the  ZR  card  for 
EAD. 

o  A  "-1"  in  columns  twenty-three  and  twenty-four  to  instruct 
EAD  to  read  the  stage-damage  curve  from  a  DSS  file. 

o  Example  EAD  input  data: 

TT 


ZR  SILVER  CREEK  BASE 
DG  1 

ZR  SILVER  CREEK  FP-3  FT 
DG  4 
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RN 

FR  RCH  1  . . . . 

.  .  .  . 

QF  RCH  11985 

1 

-1 

QS49. 0001985 

1 

-1 

DG  RCH  11985 
EP  1 

1 

-1 

DG  RCH 

11985  4 

-1 

EP 

4 

EJ 

SID,  DAMCAL,  and  EAD  automatically  generate  pathname  part  C  to  be: 

"ELEVATION-DAHAGE" . 


4 .  Summary 

Appendix  A  has  described  the  process  of  transferring  computed  results  from 
programs  HEC-1,  HEC-2,  HEC-5 ,  SID,  and  DAMCAL  to  the  EAD  program  by  using  a 
data  management  system  called  DSS.  To  access  DSS,  the  user  need  only  make 
minor  changes  to  job  control  language  and  application  program  input  data. 
Appendix  B  describes  DSS  input  modifications  to  HEC-1,  HEC-2,  and  DAMCAL.  The 
published  user's  manuals  describe  DSS  input  requirements  for  programs  HEC-5, 
SID,  and  EAD.  The  publication  "HECDSS  Users  Guide  and  Utility  Program  Manuals" 
(8)  describes  in  detail  the  DSS  data  management  system  and  its  associated 
utilities.  The  DSS  utility  program  DSSUTL  inventories  data  pathnames,  provides 
data  file  housekeeping  capability  (such  as  eliminate  or  rename  records),  and 
generates  computer  system  independent  data  files.  The  DSS  utility  program 
OSPLAT  tabulates  and  graphs  data  stored  in  a  data  file.  The  interactive 
program  PIP,  documented  in  a  separate  user’s  manual,  enables  insertion  of 
flow-exceedance  frequency,  flow- damage  elevation-exceedance  frequency, 
elevation-flow,  elevation-damage,  and  exceedance  frequency-damage  data  into 
the  DSS  file  system  where  it  then  may  be  used  identical  to  computer  program 
generated  DSS  data  records.  Although  the  application  of  the  Flood  Damage 
Analysis  Package  does  not  require  the  use  of  these  DSS  utilities,  they  provide 
the  user  with  significant  additional  flexibility  and  capabilities. 


35 


Appendix  A 


Appendix  B 

Supplementary  User  Documentation 


r  * 


36 


Appendix  B 


B.  Supplementary  User  Documentation 


1.  Introduction 

Each  program  referenced  in  this  document  has  a  user’s  manual  which 
describes  the  analytical  procedures  used  by  the  program,  the  input  to  the 
program,  the  output  from  the  program,  and  results  from  test  examples.  All  but 
two  of  the  user's  manuals  (HEC-2  and  DAMCAL)  also  describe  the  procedures  for 
use  of  the  DSS  (data  storage  system)  to  store  and  extract  data.  These  two 
manuals  will  address  the  use  of  the  DSS  in  future  revisions.  This  appendix  is 
designed  to  supplement  these  two  user  documents  to  describe  the  use  of  the  DSS 
and  the  required  input  to  enable  the  use  of  this  feature. 


2.  Supplementary  HEC-2  User  Information 

The  computer  program  HEC-2  computes  water  surface  profiles  for  river 
channels  of  any  cross  section  for  either  subcritical  or  supercritical  flow 
conditions.  The  principle  use  of  the  program  is  for  determining  profiles  for 
various  frequency  floods  for  both  natural  and  modified  conditions.  HEC-2 
generates  elevation-flow  (rating)  curves  which  can  be  written  to  a  DSS  file. 

To  accurately  define  the  rating  curves,  the  user  should  enter  the  maximum 
allowable  number  of  water  surface  profiles.  These  profiles  should  span  the 
range  of  the  flow-frequency  curves.  The  BAD  program  utilizes  the  elevation- 
flow  rating  curves  to  convert  elevation-damage  into  discharge-damage 
relationships.  The  conversion  is  performed  by  linear  interpolation.  However, 
the  BAD  program  will  not  extrapolate  the  rating  curve  if  an  elevation-damage 
coordinate  exceeds  the  maximum  elevation  ordinate  in  the  rating  curve  or  is 
less  than  the  minimum  elevation  ordinate.  HBC-2  writes  a  rating  curve  to  the 
DSS  file  for  every  cross-section.  The  analyst  may  wish  to  use  a  temporary  DSS 
file  to  store  all  the  rating  curves  in  a  reach,  and  then  copy  the  one  required 
rating  curve  at  the  index  point  into  the  permanent  DSS  file.  Required 
additions  to  the  HEC-2  program  input  follow. 


ZW  Card  -  DSS  Write  Card  (Optional,  required  for  DSS  write) 

To  write  elevation-flow  (rating)  curves  to  a  DSS  file,  the  user  must 
Insert  a  ZW  card  as  the  first  input  card  of  the  data  deck.  The  ZW  card 
contains  OSS  pathname  parts  A,B,  and  F.  HBC-2  develops  a  rating  curve  and 
stores  that  rating  curve  in  the  DSS  file  for  every  cross-section.  HEC-2  will 
use  variable  SECHO  (field  Xl-1  in  the  HBC-2  input)  to  define  part  B  of  the 
DSS  pathname.  Care  must  be  exercised  because  HEC-2  stores  variable  SECNO  as  a 
floating  point  variable  and  must  convert  it  to  a  character  string  for  use  as  a 
pathname  part.  Many  times,  the  result  will  differ  from  that  which  was  input 
by  the  user.  For  example,  the  user  may  define  the  section  number  to  be  "49” 
but  HEC-2  will  generate  part  B  of  the  pathname  to  be  "49.000". 
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Field 

Value 

Description 

0 

ZW 

Card  identification. 

1-2 

(AN) 

Study  or  Project  name  (part  A  of  the  DSS  pathname). 

3-5 

(AN) 

Plan  or  alternative  name  (part  F  of  the  DSS  pathname) . 

6 

(AN) 

Year  of  data  (part  E  of  the  DSS  pathname) .  Must  be  entered 
in  columns  45  -  48. 

J2  Card 

- Job 

Card  (required  for  DSS  write) 

•- 

‘ 


The  J2  card  is  used  to  specify  printout,  plot,  trace,  and  computational 
options.  In  order  to  initiate  the  write  to  a  DSS  file,  the  last  J2  card  must 
contain  a  "15"  in  field  1  (J2-1)  which  requests  the  summary  printout. 


Field  Variable  Value 

0  lA  J2 

1  MPROF  15 


Description 

Card  Identification. 

Indicates  last  profile  and  requests  a  summary 
printout. 

No  change  from  users  manual. 


J3  Card  -  Job  Card 


^  w  ■■ 

«  "  ■  ^  • 


The  J3  card  is  an  optional  card.  However,  if  it  is  entered,  the  user  must 
request  "Table  150".  If  the  J3  card  is  omitted.  Table  150  is  provided  by 
default . 


3.  Supplementary  DAMCAL  User  Information 


•fit,.  , 


The  computer  program  DAMCAL  can  evaluate  a  broad  range  of  alternative 
flood  damage  reduction  measures  that  will  provide  flood  damage  relief  for 
existing  and  future  land  use  conditions.  It  accesses  a  spatial  grid  cell  data 
base  file  from  which  it  extracts  information  for  flood  damage  computations. 
This  information  includes:  topographic  elevation,  reference  flood  elevation, 
damage  reach  delineation,  existing  land  use  classification,  and  alternative 
future  land  use  patterns.  Each  alternative  analysis  results  in  the  creation 
of  an  aggregated  elevation-damage  function  for  each  land  use  category  at  each 
damage  reach  index  location.  The  aggregated  elevation-damage  function  can 
then  be  stored  in  a  DSS  file  by  following  the  supplementary  instructions 
listed  below. 


L". 


vy.  . 

W**  I. 
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a.  ^  a  •  •. 


.VV-  ^ 


ZW  Card  —  Write  elevation-damaRe  function  to  a  DSS  file 

The  ZW  card  flags  the  DAMCAL  program  that  elevation-damage  functions  will 
be  stored  in  a  data  storage  system  (OSS)  data  file.  The  functions  are  stored 
by  land  use  for  each  reach.  The  ZU  card  contains  the  study,  project,  or  basin 
name,  the  study  or  plan  alternative,  and  the  data  year  associated  with  the 
computed  results.  The  ZW  card  is  placed  after  the  last  job  card  (J)  and 
before  the  format  (FT)  card. 


Field 

Value 

Description 

0 

ZW 

Card  Identification. 

1-2 

(AM) 

Study,  Project,  or  Basin  name  (part  A  of 
pathname ) . 

the 

DSS 

3-5 

(AM) 

Study  or  plan  alternative  (part  F  of  the 

DSS 

pathname) . 

6 

(AM) 

Data  year  (part  E  of  the  DSS  pathname), 
must  be  entered  in  columns  45-48. 

The 

data  year 

DT  Card  -  Damage  Reach  Title  Card 

The  OT  card  labels  the  damage  reach  and  provides  the  unique  identifier 


(name  or 

location) 

for  each  reach. 

Field 

Value 

Description 

0 

DT 

Card  Identification. 

1 

(AM) 

Damage  reach  location  or  name  (part  B  of  the  DSS 
pathname) . 

2-10 

(AM) 

Description  of  the  damage  reach  on  the  preceding  DR  card 
(DR.l). 
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C.  Flood  Damage  Analysis  Package  -  Application  Example 


1 .  Purpose 

The  purpose  of  this  appendix  is  to  provide  specific  examples  of  Flood 
Damage  Analysis  Package  program  executions  and  the  transfer  of  data  through  a 
data  management  system.  This  will  include  study  management  considerations, 
example  Job  Control  Language  (JCL) ,  input  data  considerations,  output 
analysis,  and  DSS  utility  program  application.  The  problem  presented  is 

hypothetical  and  unrealistically  simple  -  but  it  demonstrates  the  logic  in 

applying  the  Flood  Damage  Analysis  FDA  Package.  The  logic  and  procedures  are 
the  same  for  a  large  basin  with  tens  of  thousands  of  structures  and  several 
hundred  damage  reaches.  For  the  novice  computer  user,  the  mechanics  of 
applying  the  FDA  Package  are  not  trivial. 


2.  Problem  Description 

The  town  of  Riverton  is  a  relatively  new  development  located  on  the  banks 
of  Silver  Creek.  See  Figure  3.  It  consists  of  one  residential  property  and 
one  commercial  building.  This  year,  both  structures  suffered  severe  flooding. 
The  town's  citizen(s)  have  demanded  relief  from  the  flooding  and  have  insisted 
that  the  government  determine  an  effective  flood  control  measure  to 
immediately  implement. 


3.  Description  of  Study  Area 

Silver  Creek  remains  in  its  natural  state  with  a  slope  of  thirty  feet  per 
mile.  The  channel  capacity  is  limited.  Surrounding  hills  slope  steeply  into 
the  channel  except  in  the  vicinity  of  Riverton  where  a  small  flat  area  exists 


4.  Action 

In  response  to  the  public,  the  government  has  initiated  a  study  to 
evaluate  the  existing  flood  problems  and  to  formulate  and  analyze  several 
flood  damage  mitigation  plans. 


5 .  Study  Management 

An  important  first  step  in  perfoming  a  flood  damage  analysis  study  is  to 
define  the  scope  of  the  study.  This  might  include  conceptualizing  the  study 
procedure,  estimating  the  required  personnel,  determining  the  necessary 
technical  capability,  estimating  the  field  surveys,  and  estimating  the  amount 
of  required  data.  Based  on  this  early  assessment,  a  study  team  is  formed,  a 
study  manager  is  selected,  and  the  individuals  are  asked  to  help  refine  the 
study  procedure.  For  Riverton,  several  alternatives  are  considered  feasible. 
They  include:  building  an  ungated  or  gated  reservoir,  improving  the  channel, 
and  floodproofing  the  residential  and  comercial  structures.  The  following 
sequence  of  activities  has  been  adopted  for  flood  damage  analysis  aspects  of 
the  Riverton  study. 
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a  Define  the  scope  of  the  study,  including  the  likely 

conceptual  array  of  flood  damage  mitigation  alternatives. 

b  Subdivide  the  watershed  into  hydrologic  sub-basins  and 

damage  reaches  and  select  damage  index  locations. 

c  Assign  alphanumeric  identifiers  for  data  management. 

d  Define  the  computer  file  naming  conventions  for  all  the 

analyses  files  including  input,  output,  job  control 
language  (JCL),  DSS  and  other  data  files. 

e  Compute  a  base  (without)  condition  discharge-exceedance 

frequency  curve  for  each  index  location  for  Riverton. 

f  Obtain  cross-section  information  and  compute  profiles. 

g  Determine  the  reference  flood  elevations  at  the  index 

locations  and  at  each  of  the  structures. 

h  Inventory  the  damageable  structures  within  the  study  area 

and  compute  elevation-damage  relationships  at  the  index 
locations. 

i  Compute  the  expected  annual  damage  for  the  base  condition. 

j  Adjust  the  study  procedure  or  change  naming  conventions 

if  problems  have  occurred. 

k  Simulate  an  ungated  reservoir. 

1  Simulate  a  gated  reservoir. 

m  Simulate  a  channel  improvement. 

n  Floodproof  structures. 

o  Compute  the  expected  annual  damage  for  the  base  condition 

and  all  alternatives. 


6 .  Study  Procedure 

At  this  point,  the  individual  tasks  are  implemented.  The  following 
descriptions  follow  the  flood  damage  analysis  of  Riverton  through  the  tasks  as 
outlined  above. 
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a.  Formulate  flood  damage  mitigation  alternatives. 

It  is  advantageous  to  define  the  conceptual  array  of  likely  flood  damage 
mitigation  alternatives  as  early  i:s  possible.  This  enables  systematic 
subdivision  of  the  watershed  and  definition  of  damage  reaches  for  efficient 
study  of  the  alternatives.  In  addition,  it  also  provides  a  reference  for 
developing  data  for  the  base  condition  with  the  idea  of  expanding  the  analysis 
to  study  the  alternatives.  It  also  provides  a  basis  for  defining  the 
alphanumeric  identifiers  for  data  management.  Table  3  describes  the 
preliminary  plans  formulated  for  Riverton. 


Table  3:  Flood  Damage  Mitigation  Plans  For  Riverton 
Plan  Description 

1  Existing  without  (Base)  Conditions.  No  flood  plain 
management  measures  in  place. 

2  Flood  proof  both  structures  to  3  feet.  The  SID  program 
will  be  used  to  develop  a  modified  elevation-damage 
relationship. 

3  Construct  an  ungated  reservoir  upstream  of  Riverton.  The 
HEC-1  program  will  be  used  to  develop  a  modified 
discharge-exceedance  frequency  curve. 

4  Construct  a  controlled  (gated)  reservoir  upstream  of 
Riverton.  The  HEC-5  program  will  be  used  to  develop  a 
modified  discharge-exceedance  frequency  curve. 

5  Improve  the  Silver  Creek  channel  through  Riverton  by 
excavating  a  trapezoidal  section  with  a  bottom  width  of 
20  feet  and  a  side  slope  of  1.5  on  1. 

Each  of  these  plans  will  be  evaluated  by  executing  the  EAD  program.  Often 
times  is  not  possible  to  formulate  all  of  the  specifics  of  a  given  plan.  For 
example,  the  above  formulation  does  not  define  the  size  of  the  reservoir  nor 
the  allocation  of  space  within  that  reservoir  for  either  plan  three  or  four. 

As  the  study  proceeds,  it  may  require  studying  several  sizes  and  pool  storage 
allocations.  It  then  is  beneficial  to  define  those  other  altemavtives  at 
this  point.  For  this  simple  example,  only  one  size  of  reservoir  is  considered. 

b.  Select  damage  index  locations. 

Only  one  damage  reach  and  one  index  location  are  needed  for  this  study. 
Many  factors  influence  the  selection  of  the  index  locations.  These  include 
the  location  of  stream  gaging  stations,  the  uniformity  of  stream  profiles,  the 
location  of  governmental  boundaries,  and  the  characteristics  of  alternatives 
under  investigation.  It  is  desirable  but  not  always  possible  to  correctly 
identify  all  index  locations  at  the  outset  of  the  study.  For  example,  the 
hydraulic  engineer  later  may  change  stream  profiles  for  reaches  that  orginally 
were  thought  to  have  uniform  profiles.  For  Riverton,  this  is  not  the  case. 

The  hydraulic  engineer  is  consulted  to  determine  suitable  locations  for  cross- 
sections  and  the  economist  is  consulted  to  determine  the  location  of 
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damageable  property.  This  information  might  be  entered  on  a  topographic  map 
as  shovm  in  Figure  4.  From  this  information,  a  cross-section  at  river  mile 
49.0  is  selected  as  the  index  location  at  which  elevation-discharge  rating 
curves,  elevation-damage  relationships,  and  flow  exceedance  frequency  curves 
for  Riverton  will  be  developed. 

c.  Assign  alphanumeric  identifiers  for  data  management. 

Identifiers  are  chosen  for  defining  data  records  in  the  DSS  file.  The 
same  river  name  (or  basin)  is  used  for  part  A  of  the  DSS  pathname  for  all 
index  locations;  the  damage  reach  index  location  identifier  is  used  for  part  B 
of  the  OSS  pathname;  the  data-year  is  used  for  part  E  of  the  pathname;  and  the 
alternative  is  used  for  part  F  of  the  DSS  pathname. 

The  river  name  "SILVER  CREEK"  is  used  for  part  A  of  the  pathname.  This 
assignment  is  valid  since  it  is  less  than  fifteen  characters. 

The  reach  identifier  "RCH  1"  is  used  for  part  B  of  the  pathname  (must  be 
six  characters  or  less).  If  possible,  the  identifier  is  chosen  in  such  a  way 
that  index  locations  can  be  added  later  and  assigned  logical  names.  It  is 
anticipated  that  no  reaches  will  be  added  for  the  Silver  Creek  study. 

Blank  character.^  are  used  for  part  E  of  the  pathname.  The  relationships 
do  not  vary  with  time  so  equivalent  annual  damage  will  not  be  computed. 

Part  F  of  the  OSS  pathname  is  defined  according  to  Table  4  (this  part  must 
be  twenty-two  characters  or  less). 


Table  4:  Pathname  Part  F  For  Silver  Creek 
Plan  Part  F  of  the  DSS  pathname 

1  BASE 

2  FP-3  FT 

3  UNGTD  RES 

4  GATED  RES 

5  CHIMP-20  FT  BW 


d.  efine  the  computer  file  naming  conventions  for  all  files. 

The  Riverton  study  involves  the  application  of  HEC-1  (ungated  reservoir), 
HBC-5  (gated  reservoir),  HEC-2  (rating  curves),  SID  (inventory  structures), 
and  EAD  (expected  annual  damage).  A  consistent  file  naming  scheme  simplifies 
file  management  and  facilitates  better  communication.  File  names  are  limited 
to  seven  characters.  File  naming  extensions  are  used  to  identify  the  type  of 
file.  For  example,  the  characters  ".J"  or  just  ”J"  are  used  to  identify  a 
file  containing  job  control  language  ( JCL) .  Part  of  the  basin  name  is 
included  to  identify  files  associated  with  this  study.  Additional  characters 
identify  the  program  and  the  alternative.  The  following  naming  convention  is 
used  for  the  Riverton  study. 
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Character 

Location 


1-3 


4-5 


6 


Contents 


River  name  abbreviation  to  indicate  study;  "SLV" 
is  used  for  all  files. 

Alternative  indicator;  "AO"  would  indicate  base 
condition  ("0")  for  alternative  "A"  whereas  "Al" 
would  indicate  condition  "1"  for  alternative 
"A".  The  condition  assumes  an  alphanumeric 
value  for  some  cases.  Examples  of  this  are  the 
EAD  input  data  file  which  analyzes  multiple 
conditions  or  the  DSS  file  that  contains  results 
for  many  alternatives. 

Computer  program  identifier;  indicates  with 
which  program  the  file  is  associated.  Character 
is  taken  from  the  reference  list  shown  below: 


7 


Character  Program 


1  HEC-1 

2  HEC-2 

5  HEC-5 

S  SID 

D  DAMCAL 

E  EAO 


Type  of  file;  indicates  the  nature  of  the 
file.  Taken  from  the  reference  list  below: 


Character  File  Type 


I  Input  data  file. 

0  Computer  program  output  listing. 

J  Job  control  language  to  execute  program. 

Z  OSS  data  file. 


Typical  file  names  are  listed  below. 

Filename  Description 

SLVAOII  Input  data  file  to  HEC-1  for  base  condition. 

SLVAOIJ  Job  control  language  to  execute  HEC-1  for  base  condition. 
SLVAOlO  Program  printout  from  HEC-1  for  base  condition. 

SLVAOSI  Input  data  file  to  SID  for  base  condition. 

SLVAOEI  Input  data  file  to  EAD  for  base  condition. 

SLVAAIZ  Intermediate  DSS  file  containing  HEC-1  computed 
hydrographs . 
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The  most  important  file  is  the  DSS  file  through  which  all  FDA  programs 
communicate.  Only  one  file  is  used  for  storing  and  retrieving  the  basic 

economic  relationships  -  frequency  curves,  elevation-discharge  rating 

curves,  and  elevation  damage  relationships.  The  Riverton  DSS  file  is  named 
"SLVAAEZ*'.  Other  variations  are  possible.  Some  analysts  like  to  include  the 
characters  ''DSS’’  in  the  file  name  or  add  a  specific  character  extension. 
Examples  using  this  notation  include;  "SILVDSS"  or  "DSSSILV”,  or  "SILVR.Z". 

There  is  merit  to  using  more  than  one  DSS  file  in  a  flood  damage  analysis 
study.  Separate  files  are  maintained  for  time  series  data  and  paired 
function  data  to  reduce  the  management  overload  of  large  DSS  data  files.  In 
the  Riverton  study,  four  DSS  files  are  used.  The  file  names  and  descriptions 
are  shown  below: 


Description 


SLVAAEZ  Master  DSS  file.  It  contains  all  flow-frequency  curves, 
elevation-discharge  rating  curves  at  index  locations,  and 
elevation-damage  relationships  for  each  reach.  The  EAD 
program  will  access  this  file  to  retrieve  all  the 
parametric  relationships  used  in  the  computation  of 
expected  annual  damage  for  base  condition  and  all 
alternatives. 


SLVAAIZ  DSS  file  to  contain  hydrographs  and  frequency  curves 

which  were  computed  by  the  HEC-1  program.  HEC-1  writes 
hydrographs  and  frequency  curves  to  the  same  DSS  file. 

The  use  of  this  intermediate  DSS  file  facilitates  the 
storage  of  hydrographs  separate  from  the  the  master  DSS 
file  which  will  contain  only  the  basic  economic 
relationships.  The  DSS  utility  program  DSSUTL  is  used  to 
"copy"  the  flow-frequency  curves  from  this  DSS  file  into 
the  master  DSS  file  "SLVAAEZ".  When  analyzing  a  gated 
reservoir,  HEC-5  will  utilize  hydrographs  from  this  file 
as  incremental  local  inflows.  If  HEC-1  does  not  store 
hydrographs  in  a  DSS  file,  then  the  frequency  curves  are 
stored  directly  into  the  master  DSS  file  "SLVAAEZ". 


SLVAA2Z  DSS  file  to  contain  elevation-discharge  rating  curves  for 
each  cross-section  as  computed  by  HEC-2.  This  temporary 
DSS  file  .Is  used  because  HEC-2  stores  rating  curves  in 
the  DSS  file  for  all  of  the  cross-sections  input  to  it. 
Subsequent  analyses  will  require  rating  curves  at  only 
the  index  points.  This  intermediate  DSS  file  facilitates 
the  screening  out  of  unnecessary  rating  curves.  The  OSS 
utility  program  DSSCITL  is  used  to  "copy"  the  rating  curve 
at  the  damage  index  point  into  the  master  DSS  file 
"SLVAAEZ" . 


SLVAA5Z  OSS  file  to  contain  hydrographs  computed  by  the  HEC-5 
program. 
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e.  Compute  base  frequency  curve  for  each  index  location. 

A  stream  gaging  station  does  not  exist  near  Riverton.  If  one  were  present 
for  a  reasonable  length  of  time  (twenty  years  or  more)  or  if  it  were  in 
existence  during  a  significant  storm,  the  data  could  be  used  to  help  construct 
a  discharge-exceedance  frequency  curve.  Since  a  gaging  station  does  not 
exist,  a  rainfall-runoff  model  is  developed.  The  analyst  is  given  the 
location  of  cross-section  49.0  at  which  the  frequency  curve  is  developed.  The 
frequency  curves  may  be  developed  using  any  number  of  publications  such  as  the 
National  Weather  Service’s  Technical  Paper  40  (TP-40),  the  National  Oceanic 
and  Atmospheric  Administration  Technical  Memorandum  NWS  Hydro-35,  the  L'.S. 

Army  Corps  of  Engineers  Civil  Engineer  Bulletin  No.  52-8,  ’’Standard  Project 
Flood  Determinations",  as  well  as  any  local  technical  publications  or 
newspapers.  Rainfall-runoff  modeling  requires  the  estimation  of  runoff 
response  hydrograph  parameters  and  rainfall  loss  parameters  such  as 
infiltration.  For  Riverton,  a  simple  rainfall  runoff  model  is  developed  since 
the  watershed  is  small.  It  is  determined  that  hydrologic  routing  parameters 
are  not  required.  This  document  will  not  address  the  details  of  the  frequency 
curve  development.  Other  HEC  publications  are  available  on  the  subject.  The 
analyst  has  determined  the  base  condition  frequency  curve  shown  in  Table  5. 


Table  5:  Base  Condition  Discharge-Exceedance  Frequency 


Exceedance 

Frequency (%)  Discharge  (cfs) 


90 

80 

70 

60 

50 

40 

30 

20 

10 

5 

2 

1 


0.5 

0.2 


0.1 

0.01 


1000 

1150 

1270 

1400 

1550 

1700 

1860 

2100 

2550 

3000 

3750 

4350 

5300 

6700 

7800 

12000 


Notice  the  extreme  exceedance  frequencies  used  to  define  the  curve  (90% 
through  .01%  chance  exceedance).  The  lowest  flow  point  on  the  curve  must  be 
less  than  the  "zero"  damage  discharge  (no  damage  occurrs  for  flow  below  this 
discharge)  and  the  highest  point  on  the  curve  should  be  a  rare  event  (.1 
percent  or  greater)  so  expected  annual  damage  may  be  accurately  computed.  The 
base  condition  flow-frequency  curve  is  either  stored  directly  into  the  master 
DSS  file  "SLVAAEZ"  using  for  example  the  PIP  program  as  an  input  aid  or  is 
input  to  the  HEC-1  program  as  part  of  a  rainfall-runoff  simulation  input  data 
file.  For  Riverton,  the  flow-frequency  curve  is  input  to  HBC-1.  The  file 
SLVAOll  contains  data  to  simulate  rainfall-runoff  above  Riverton.  It  contains 
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three  control  points  -  two  at  the  location  of  a  proposed  reservoir  and  one 

at  the  damage  index  point  in  Riverton.  The  damage  index  point  corresponds  to 
cross-section  A9.0.  The  HEC-1  input  and  output  is  shown  below. 
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m  DAMAGE  DATA  (OD  OR  SO  CAROS)  FOR  THIS  LOCATION 
SO  DAMAGES  WILL  NOT  BE  CALCULATED. 
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f.  Obtain  cross-section  information  and  compute  profiles. 

In  extensive  studies,  aerial  photography  is  used  in  addition  to  field 
surveys  to  derive  cross-section  data.  Sometimes,  local  communities  have 
obtained  detailed  topography  (two-foot  contour  interval).  For  the  Riverton 
study,  field  surveys  are  used  to  obtain  cross-section  data.  Care  is  taken  to 
obtain  data  at  the  damage  index  location  identified  as  river  mile  49.0.  A 
plot  of  this  cross-section  and  computed  water  surface  elevations  is  shown  in 
Figure  5.  Additional  topography  is  needed  for  reservoir  sites.  Some 
estimation  is  made  of  the  elevation-storage  capacity  p<  ssible  at  the  damsite 
upstream  from  Riverton. 

An  HBC-2  data  file  is  constructed  to  compute  stream  profiles  on  Silver 
Creek  through  Riverton.  A  "ZW  card  is  included  to  store  rating  curves  in  an 
intermediate  DSS  file  names  "SLVAA22'*.  After  executing  HBC-2,  OSSUTL  is 
executed  to  copy  the  rating  curve  at  river  mile  49.0  from  the  intermediate  DSS 
file  named  "SLVAA2Z"  into  the  master  DSS  file  called  “SLVAABZ".  Below  is  a 
selective  listing  of  the  HBC-2  output.  It  is  followed  by  the  execution  of 
DSSUTL  to  copy  the  rating  curve  into  the  master  DSS  file. 
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Confirmation  that  rating  curves  are 
written  to  the  DSS  file. 
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g.  Determine  the  reference  flood  elevations. 

Reference  flood  elevations  are  needed  before  an  elevation- damage 
relationship  can  be  compiled  for  the  damage  reach  index  location  (river  mile 
49.0  in  Riverton).  This  requires  either  the  use  of  historic  flood  information 
or  a  stream  profile  analysis  using  HEC-2.  See  the  SIO  user's  manual  for  a 
discussion  of  the  reference  flood.  For  the  Riverton  study,  observations  from 
a  recent  major  flood  are  used  for  the  reference  elevations.  Table  6  tabulates 
this  data. 


Table  6;  Reference  Flood  Elevations 
Location  Flood  Elevations 


Index  location  3466.5 
Residential  structure  3464.8 
Commercial  structure  3465.9 


The  residential  and  commercial  structure  reference  flood  elevations  are 
input  on  the  SID  structure  records  (variable  ADJ)  and  the  index  location 
reference  flood  elevation  input  on  the  reach  record. 

The  output  from  the  base  condition  SIO  run  follows  paragraph  h  below. 


h.  Compute  elevation-damage  relationships  at  the  index  location. 

This  step  includes  locating  and  categorizing  all  structures  in  the  flood 
plain  and  developing  or  adapting  standard  stage  percent  damage  functions  for 
categories  of  structures  and  their  contents  in  Riverton.  Stage  versus  percent 
damage  relationships  are  obtained  for  structures  of  this  type  in  the  area. 
Field  surveys  of  Riverton  reveal  two  types  of  structures  (one  residential  and 
one  commercial),  their  estimated  real  estate  value  in  dollars  (for  both  the 
structure  as  well  as  it's  contents),  and  each  structures'  finished  floor 
(first)  elevations.  These  data  are  listed  in  Table  7. 


Table  7:  Structure  Inventory  For  Riverton 
Structure  and  Content  Value  ($1000) 


Item 

Value 

Residential  structure 

$130. 

Residential  contents 

$  65. 

First  floor  elevation 

3463.8 

Commercial  structure 

$  60. 

Commercial  contents 

$250. 

First  floor  elevation 

3462.4 
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The  adapted  damage  functions  were  taken  from  a  recent  study  within  the 
area  and  are  tabulated  in  Table  8. 


Table  8:  Base  Condition  Elevation-Damage  Functions 
Residential  Structures 


Stage 

(feet) 

-2 

0 

2 

6 

15 


Stage 

(feet) 

0 

1 

10 

15 


Damage  to  structure 

Damage  to  Contents 

(percent  of 

Stage 

(percent  of 

structure  value) 

contents  value) 

0 

-2 

0 

19 

0 

0 

31 

2 

75 

53 

6 

100 

100 

15 

100 

Commercial 

Structures 

Damage  to  structure 

Damage  to  Contents 

(percent  of 

Stage 

(percent  of 

structure  value) 

contents  value) 

0 

0 

0 

33 

5 

89 

40 

10 

100 

100 

The  SIO  user’s  manual  contains  a  sample  structure  inventory  form  which  is 
very  useful  for  performing  field  surveys.  Tables  9  and  10  contain  the  field 
inventory  forms  for  Riverton.  The  output  from  the  base  condition  SIO  run  then 
follows. 
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■  *  ■  • 

lVW.  v'f 


DAMAGE  CATEGORY  RESONTL  IDENTIFIED  AS  RESIDENTIAL  STRUCTURE  AND  CONTENTS 


i.  Compute  the  expected  annual  damage  for  the  base  condition. 

At  this  point,  all  the  pertinent  relationships  for  the  base  condition 
have  been  stored  in  the  master  DSS  file  named  '’SLyAAEZ".  A  data  file  named 
"SLVAOKI”  is  developed  to  compute  expected  annual  damage  for  the  base 
condition. 

Data  stored  in  the  DSS  file  may  be  examined  at  any  time.  It  may  at  times 
be  useful  to  check  the  data  before  submitting  the  BAD  run.  This  is  easily 
done  by  using  the  DSS  utility  programs  DSSUTL  to  catalog  the  file  and  tabulate 
the  data  and  DSPLAY  to  tabulate  and  plot  the  data.  It  is  possible  to  input 
data  directly  into  the  DSS  file.  For  illustration  purposes,  the  base 
condition  frequency  curve  is  input  and  (later)  compared  to  the  automatically 
inserted  curve.  This  entails  directly  storing  the  input  curve  into  the  DSS 
file  using  the  PIP  program  (reference  10).  The  output  below  demonstrates  the 
application  of  these  programs.  This  is  a  good  time  to  verify  that  the  rating 
curves  are  properly  defined  (the  lowest  discharge  is  below  the  lowest  point  on 
the  flow-frequency  curve  and  the  highest  point  is  above  the  maximum  damage 
elevation),  the  frequency  curves  are  properly  defined  (the  lowest  discharge  on 
the  curve  is  non-damaging  and  the  highest  point  is  very  rare  (on  the  order  of 
.2%  chance  exceedance),  and  the  elevation-damage  relationships  are  well 
defined.  Careful  examination  of  the  results  of  the  EAD  run  will  also  reveal 
whether  the  data  ranges  input  have  been  appropriate.  Notice  that  the 
frequency  curve  stored  in  the  DSS  file  is  virtually  identical  to  the  one  which 
was  input  to  HEC-1.  It  is  based  on  the  ratios  which  were  selected  on  the  JR 
card  in  the  HEC-1  input  data  file.  The  flow-exceedance  frequency  curves  are 
shown  in  Figure  6,  the  elevation-flow  rating  curve  at  river  mile  49.0  is  shown 
in  Figure  7,  and  the  elevation-damage  relationships  for  both  damage  categories 
of  reach  one  in  Riverton  are  shown  in  Figure  8. 
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Enter  base  condition  frequency 
curve  directly  to  DSS  data  file 
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EXPECTED  ANNUAL  FLOOD  DANAGE  COMPUTATION 
761-X6L7580  FEBRUARY  1984 
VERSION  DATE  MARCH  5,  1985 
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RCH  1  REACH  1,  RIVERTON 


'*  FLOOD  PLAIN  HANAGEHENT  PLANS 
1  -  EXISTING  CONDITIONS 


j.  Adjust  procedure  or  change  naming  conventions  if  needed. 


At  this  point,  the  base  condition  damage  is  determined.  It  is  a  good 
time  to  assess  the  successfulness  of  the  study  procedure  to  determine  if 
adjustments  are  necessary.  If  mistakes  or  misunderstandings  in  data 
management  naming  conventions  have  caused  inconsistences  in  data  storage, 
these  are  corrected  both  in  the  master  data  base  file  "SLVAAEZ”,  as  well  as 
all  intermediate  DSS  files  and  input  data  files.  The  output  from  the  EAO 
program  is  checked  to  ensure  that  frequency  curves  are  properly  defined,  that 
elevation-damage  relationships  span  the  range  of  damageable  property,  and  that 
rating  curves  have  properly  converted  elevation  to  discharge. 

Once  it  is  determined  that  all  relationships  are  properly  defined  and 
that  the  study  procedure  is  sound,  the  flood  damage  mitigation  measures 
formulated  earlier  are  studied.  This  process  involves  study  team 
communication  because  some  alternatives  involve  interdependent  modifications 
to  the  basic  hydrologic  relationships. 


k.  Simulate  an  ungated  reservoir. 

HEC-1  simulates  an  ungated  reservoir  located  above  Riverton.  The  basic 
hydrologic  model  exists  as  a  result  of  analyzing  the  base  condition.  It 
includes  the  base  condition  frequency  curve.  Only  minor  modifications  are 
required  to  simulate  the  reservoir  and  compute  the  modified  frequency  curve. 
The  second  control  point  was  established  to  accomodate  the  ungated  reservoir 
plan  even  though  it  was  not  needed  for  base  condition.  The  elevation- 
storage-discharge  relationships  are  entered  at  control  point  2  in  the 
hydrology  section  of  input  for  "plan  2’*  (from  the  standpoint  of  HBC-1  internal 
computations)  and  apprpriate  "PN"  and  "ZW"  cards  are  entered  in  the  economics 
section  of  input  to  trigger  the  writing  of  a  modified  frequency  curve  to  the 
DSS  file.  The  HEC-1  output  for  the  ungated  reservoir  follows  below. 
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1.  simulate  a  gated  reservoir. 

HEC-5  simulates  a  gated  reservoir  located  above  Riverton.  A  basic 
hydrologic  model  is  developed  that  is  very  similiar  to  that  developed  for  the 
ungated  reservoir  using  HEC-1.  The  input  data  includes  the  base  condition 
frequency  curve.  The  elevation-storage-discharge  relationships  are  entered  at 
control  point  2.  HEC-5  computes  and  stores  three  frequency  curves  in  one 

record  -  the  first  curve  is  the  modified  curve  representative  of  the  gated 

reservoir  condition,  the  second  curve  is  the  base  condition  frequency  curve 
computed  by  HEC-5,  and  the  third  curve  is  a  frequency  curve  derived  from  the 
local  uncontrolled  discharge.  Only  the  first  curve  (the  modified  curve)  is 
used  in  the  expected  annual  damage  calculations  and  the  others  are  ignored. 

Due  to  the  gate  operation  capabilities,  HEC-5  may  compute  a  modified 
frequecy  curve  containing  inconsistent  flow  reductions  as  shown  in  Figure  9. 
HEC-5  allows  the  user  to  change  the  order  and  method  of  arraying  the  points  or 
the  analyst  can  use  the  DSSUTL  program  to  edit  the  modified  curve,  if 
desirable.  Damage  relationships  are  still  required  input  in  order  to  write 
the  frequency  curves  to  the  DSS  file.  "Dummy"  data  is  input  on  the  DC  cards  as 
shown  in  the  run  below.  An  execution  of  DSPLAY  follows  the  HEC-5  output.  It 
tabulates  and  plots  the  frequency  curves  computed  by  HEC-5  for  the  gated 
reservoir  condition. 
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HEC-5  SIHULATION  OF  FLOOD  CONTROL 
AND  CONSERVATION  SYSTEHS 
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SILVER  CREEK 


5 


m.  Simulate  a  channel  improvement. 

The  proposed  channel  improvement  is  easily  modeled  using  the  HEC-2 
program.  The  base  condition  input  data  file  is  modified  by  inserting  a  "Cl" 
card  (or  cards)  and  modifying  the  "ZW”  card  to  identify  part  F  of  the  DSS 
pathname  for  this  alternative  plan.  The  improved  cross-section  at  river  mile 
49.0  is  shown  in  Figure  10.  As  in  the  base  condition  analysis,  the  computed 
rating  curves  are  written  to  the  intermediate  DSS  file  ’’SLVAA2Z"  and  then  the 
curve  at  the  index  location  (river  mile  49.0)  is  copied  to  the  master  DSS  file 
’’SLVAAEZ"  using  the  DSSUTL  program.  Selected  portions  of  the  HEC-2  output  are 
shown  below.  It  is  followed  by  the  DSSUTL  program  execution  that  copies  the 
rating  curve  to  the  master  DSS  file. 
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n.  Floodproof  structures. 


The  floodproofing  alternative  plan  is  easily  modeled  using  the  SIO 
program.  The  SID  base  condition  input  deck  is  modified  to  indicate: 

a.  Floodproofing  of  all  structures 

b.  Floodproofing  to  three  foot  depth  for  both  categories 

c.  Part  F  of  the  DSS  pathname  is  changed  to:  "FP-3  FT"  The  SID  program 
calculates  a  modified  elevation-damage  relationship  for  RCH  1  and  writes  it  to 
the  master  DSS  file  "SLVAAEZ".  Selected  portions  of  the  SID  output  are  shown 
below. 
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lOAd)  =  1.  RUN  RAISIKG  STRUCTURES  FIRST 


DAMAGE  CATEGORY  RESDMTL  IDENTIFIED  AS  RESIDENTIAL  STRUCTURE  AND  CONTENTS 
DAMAGE  CATEGORY  COMERCL  IDENTIFIED  AS  COMMERCIAL  STRUCTURE  AND  CONTENTS 
DAMAGE  CATEGORY  OTHER  IDENTIFIED  AS  OTHER  DAMAGE  CATEGORIES 


o.  Compute  the  expected  annual  damage  for  all  alternatives. 

The  EAD  program  will  easily  compute  the  inundation  reduction  benefits  for 
the  four  alternative  plans.  All  of  the  basic  relationships  are  stored  in  the 
master  DSS  file  "SLVAAEZ'’.  The  EAD  input  data  file  is  enlarged  to  include 
five  "PN"  cards  (one  for  each  plan),  seven  "ZR”  cards,  and  the  additional  data 
cards  to  read  the  parametric  relationships  from  the  DSS  file  for  each  plan. 

The  selected  portions  of  the  EAD  output  are  listed  below.  The  analyst  need 
not  enter  a  "ZR"  card  for  each  relationship  for  each  plan.  This  is 
demonstrated  in  the  EAD  output  below.  For  example,  the  base  condition  flow- 
frequency  curve  is  used  for  plans  one,  four,  and  five.  "ZR"  cards  referencing 
the  frequency  curves  are  entered  for  plans  1,  2,  and  3.  The  "QF"  cards  for 
plans  4  and  5  actually  reference  the  "ZR"  card  for  plan  one  (base  condition). 
When  referencing  a  relationship  for  a  previous  plan  like  this,  it  is  good 
practice  to  enter  the  plan  number  in  the  first  field  of  every  "EP"  (or  "EJ") 
card  so  that  the  output  will  be  properly  labeled.  Figure  11  is  a  plot  of  the 
damage -exceedance  frequency  relationship  that  result  for  each  of  the 
alternative  plans.  Similar  plots  may  be  produced  for  any  of  the  data  items 
involved  in  the  damage  computation  process. 
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